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Avant-propos 



Cet ouvrage est destine, en priorite, a ceux qui veulent se former a PHP 5 et aux bases de 
donnees MySQL et SQLite pour creer des pages Web dynamiques et interactives. Nous y 
presentons a la fois les bases du langage, qui etaient celles de PHP 4, et les importantes 
nouveautes de la version 5, qui represente une evolution majeure. PHP s'est encore enri- 
chi dans la version 5.3, sujet de cette seconde edition, en particulier dans le domaine des 
objets avec, entre autres, 1' apparition des namespaces (espaces de noms) y compris 
l'emploi du mot-cle use, du namespace global, des alias et des appels de variables stati- 
ques, ainsi que le Late State Binding et la creation de constantes et de fonctions dans les 
namespaces. Notons egalement l'apparition de l'extension mysqli, qui permet un acces 
objet riche a MySQL, et de la couche d' abstraction PDO qui autorise 1' acces aux bases 
de donnees les plus diverses. Avec la version 5.3 utilisee dans cette nouvelle edition, PHP 
confirme qu'il est un langage encore plus professionnel et solide, tout en conservant la 
simplicite et l'efficacite qui ont fait son immense succes. 

Les exercices proposes a la fin de chaque chapitre vous permettront une application 
immediate des points etudies et, grace aux travaux personnels proposes a la fin de 
l'ouvrage, vous pourrez mettre en oeuvre l'ensemble des connaissances acquises dans 
des cas reels de sites Web dynamiques. 

Les corriges de ces exercices, telechargeables sur le site www.editions-eyrolles.com, ainsi que 
visibles et executables sur le site www.funhtml.com, vous permettront de mesurer votre 
comprehension des notions abordees. 

L'ouvrage est divise en vingt et un chapitres, qui abordent successivement les sujets 
suivants : 

• Le chapitre 1 rappelle le fonctionnement general de PHP dans la creation de pages 
dynamiques. II montre comment installer les outils necessaires aux tests des scripts, en 
particulier le serveur Web Apache/PHP/MySQL, et dresse l'inventaire des nouveautes 
de PHP 5. 

• Le chapitre 2 definit les differents types de donnees manipulables avec PHP et montre 
comment les utiliser en creant des variables ou des constantes. 

• Le chapitre 3 fait un tour d'horizon des instructions de controle indispensables a tout 
langage. II montre comment creer des instructions conditionnelles et des boucles ainsi 
que gerer les erreurs par le mecanisme des exceptions, une des nouveautes de PHP 5. 
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Le chapitre 4 traite de la creation et de la manipulation des chaines de caracteres. II 
decrit les differentes techniques d'affichage, simple ou formate, des chaines et presente 
l'ecriture d'expressions regulieres. 

Le chapitre 5 se penche sur la creation de tableaux, un type de donnees tres pratique 
aux multiples applications. Diverses techniques de lecture des tableaux sont explici- 
tees a l'aide de nombreux exemples. 

Le chapitre 6 detaille la creation des formulaires, qui sont les vecteurs indispensables 
au transfert d' informations entre le poste client et le serveur. II montre comment recu- 
perer et gerer les donnees saisies par les visiteurs d'un site. 

Le chapitre 7 est consacre aux fonctions qui permettent une meilleure organisation 
des scripts. Le passage d' arguments par valeur et par reference ainsi que la gestion des 
parametres et le retour des valeurs multiples par une fonction y sont detailles. 

Le chapitre 8 fait le tour des outils permettant le calcul des durees et la gestion des 
dates et des calendriers avec PHP. 

Le chapitre 9 aborde le nouveau modele objet de PHP 5 et introduit les nouvelles 
methodes qui revolutionnent la creation d'objets avec PHP, le rapprochant ainsi des 
langages de POO. 

Le chapitre 10 montre comment PHP est capable de creer, eventuellement a partir de 
donnees, des images dynamiques au format GIF, JPEG ou PNG selon les besoins, 
susceptibles de rendre les sites plus attractifs. 

Le chapitre 1 1 aborde la gestion des fichiers sur le serveur et livre une premiere appro- 
che du stockage, sur le serveur, d' informations issues du poste client. Les differentes 
methodes de creation de fichiers, de lecture et d'ecriture de donnees y sont decrites en 
detail. 

Le chapitre 12 est dedie a la creation et a la gestion des cookies ainsi qu'au mecanisme 
des sessions, qui permet la conservation et la transmission d' informations entre toutes 
la pages d'un meme site. La creation et l'envoi d'e-mail pour renforcer les possibilites 
de contact entre l'internaute et le site sont egalement abordes. 

Le chapitre 13 rappelle les notions theoriques indispensables a la modelisation d'une 
base de donnees. II dresse une rapide synthese du modele entite/association et du 
passage au modele relationnel, qui est utilise par la plupart des SGBD actuels, en 
particulier MySQL et SQLite, qui font l'objet des chapitres suivants. 

Le chapitre 14 est un rappel du langage SQL en vue de son utilisation dans MySQL. 
Ce survol est realise en dehors du contexte PHP au moyen de l'interface de gestion 
phpMy Admin. 

Le chapitre 15 explique comment acceder a une base MySQL au moyen de scripts 
PHP de maniere procedurale classique dans le cadre d'un site. Y sont abordees les 
differentes commandes d'insertion et de mise a jour de donnees ainsi que de lecture et 
de recherche elaborees sur une ou plusieurs tables au moyen de jointures. 
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Le chapitre 16 utilise l'extension mysqli introduite dans les dernieres versions de 
PHP 5 qui permet un acces purement objet a MySQL. Elle enrichit considerablement 
les possibilites par rapport a l'acces procedural, aborde au chapitre 15, qui etait de 
mise jusqu'a present. 

Le chapitre 17 presente la couche d'abstraction PDO qui permet l'acces a MySQL 
mais egalement a d'autres bases de donnees et qui est une solution d'avenir dans ce 
domaine. 

Le chapitre 18 aborde la base de donnees embarquee SQLite, une des nouveautes de 
PHP 5. Nous l'envisageons successivement avec la methode procedurale puis avec la 
methode objet, plus proche de la nouvelle orientation de PHP 5. 

Le chapitre 19 devoile une autre nouveaute de PHP 5, SimpleXML, qui permet de 
manipuler, d'une maniere nettement simplifiee par rapport a celle de la version prece- 
dente, des fielders XML en lecture et en ecriture. 

Le chapitre 20 presente PEAR, le framework PHP le plus celebre et le plus repandu, 
puis en donne une application complete pour la creation de formulaires a partir des 
classes specialisees fournies dans le package QuickForm. 

En conclusion, le chapitre 21 est constitue de quatre sujets de travaux personnels, que 
vous devrez realiser en faisant appel aux connaissances acquises tout au long des 
chapitres precedents. De difficulte croissante, ces sujets vous permettront d'evaluer de 
maniere concrete la pertinence de vos acquisitions. Les corriges de ces travaux person- 
nels sont donnes et utilisables sur le site : http://www.funhtml.com. 
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Introduction 



Le sigle PHP signifiait a l'origine Personal Home Page. Pour Rasmus Lerdorf, l'auteur 
de ce qui allait devenir le langage de script cote serveur incorporable dans tout document 
XHTML que nous connaissons, il s'agissait alors d'ajouter quelques fonctionnalites a ses 
pages personnelles. PHP signifie aujourd'hui Php Hypertext Preprocessor car il renvoie 
a un navigateur un document XHTML construit par le moteur de script Zend Engine 2 de 
PHP, dont nous allons voir le fonctionnement. II permet de creer des pages Web dynami- 
ques et interactives. 

Imaginez que vous soyez fan de moto et que vous vouliez presenter les photos de vos 
modeles preferes et leurs caracteristiques techniques. La creation de quelques pages 
XHTML statiques, agrementees de liens pour naviguer d'une page a l'autre, peut suffire. 
Imaginez maintenant que vous soyez rejoint par d'autres personnes qui partagent la 
meme passion et que votre site presente des centaines de modeles et une rubrique de 
petites annonces et de contacts entre membres. La quantite d' informations a presenter ne 
permet plus de naviguer dans le site au moyen de liens mais reclame, des la page 
d'accueil, un moteur de recherche. L'utilisateur saisit un ou plusieurs criteres de recher- 
che, a partir desquels le code d'un script PHP cree une page contenant les informations 
recherchees et seulement elles. Chaque visiteur et chaque besoin particulier generent 
done des pages differentes, personnalisees, construites dynamiquement. 

PHP permet en outre de creer des pages interactives. Une page interactive permet a un 
visiteur de saisir des donnees personnelles. Ces dernieres sont ensuite transmises au 
serveur, oil elles peuvent rester stockees dans une base de donnees pour etre diffusees 
vers d'autres utilisateurs. Un visiteur peut, par exemple, s'enregistrer et retrouver une 
page adaptee a ses besoins lors d'une visite ulterieure. II peut aussi envoyer des e-mails 
et des fichiers sans avoir a passer par son logiciel de messagerie. En associant toutes ces 
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caracteristiques, il est possible de creer aussi bien des sites de diffusion et de collecte 
d' information que des sites d'e-commerce, de rencontres ou des blogs. 

Pour contenir la masse d' informations collectees, PHP s'appuie generalement sur une 
base de donnees, generalement MySQL mais aussi SQLite avec PHP 5, et sur des serveurs 
Apache. PHP, MySQL et Apache forment d' ailleurs le trio ultradominant sur les serveurs 
Internet. Quand ce trio est associe sur un serveur a Linux, on parle de systeme LAMP 
(Linux, Apache, MySQL, PHP). PHP est utilise aujourd'hui par plus de la moitie des 
sites de la planete et par les trois quarts des grandes entreprises francaises. Pour un 
serveur Windows, on parle de systeme WAMP, mais ceci est beaucoup moins courant. 

Vous passerez en revue dans le cours de cet ouvrage tous les outils necessaires a la realisa- 
tion d'un site dynamique et interactif a l'aide de PHP et d'une base de donnees MySQL ou 
SQLite. Les principaux avantages de ces outils sont la facilite d'apprentissage, la grande 
souplesse d' utilisation, l'excellent niveau de performance et, ce qui ne gate rien, la gratuite. 

Pour parvenir a la realisation des types de site que nous venons de voir nous allons 
aborder successivement les points suivants : 

• La syntaxe et les caracteristiques du langage PHP, dont la connaissance est la base 
indispensable a toute la suite. 

• Les notions essentielles du langage SQL permettant la creation et la gestion des bases 
de donnees et la realisation des requetes sur ces bases. 

• Le fonctionnement et la realisation de bases de donnees MySQL puis SQLite et les 
moyens d'y acceder a l'aide des fonctions specialisees de PHP ou d'objets. 

Pour progresser rapidement il vous sera necessaire de lire ce livre de maniere lineaire au 
moins pour le debut et de ne pas bruler les etapes. N'essayez done pas de commencer par 
la fin en abordant les bases de donnees sans connaissance prealable de PHP ou de SQL. 

Avant de commencer 

Avant d'envisager d'ecrire votre premier script, il vous faut faire le point sur les connais- 
sances necessaires a cette realisation. II n'est pas envisageable de commencer cet appren- 
tissage sans aucune connaissance d'Internet et de la creation de pages XHTML. Du point 
de vue materiel, vous devez de surcroit disposer des quelques outils qui vous permettront 
d'ecrire et surtout de tester vos scripts sur un ordinateur personnel. 

Competences requises 

L'objectif de cet ouvrage etant de permettre un apprentissage progressif de PHP5, la 
connaissance d'un langage de programmation quelconque n'est pas vraiment indispensable. 
Cependant, quelques notions de programmation en langage C, Java ou en JavaScript, par 
exemple, ne peuvent que rendre l'acces a PHP plus facile. En revanche, la connaissance 
du langage XHTML est recommandee puisque le serveur PHP renvoie les pages XHTML 
que vous programmez. 
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Pour ce qui concerne la methode, commencez par telecharger et tester les exemples du 
livre, puis modifiez-en certains parametres afin d'evaluer le role de chacun d'eux. Cela 
vous permettra de mieux apprecier l'effet reel d'une instruction, par exemple. 

Les outils de creation 

Puisqu'il s'agit de construire des pages Web et de produire un document HTML lisible 
par un navigateur, un editeur HTML peut convenir pour creer la structure generale des 
pages, y compris s'il est WYSIWYG, comme Dreamweaver ou WebExpert. Le code des 
scripts PHP peut quant a lui etre ecrit dans n'importe quel editeur de texte, tel que le 
Bloc -notes de Windows. 

Si les editeurs tels que Dreamweaver privilegient 1' aspect visuel en cachant le code, 
d'autres outils de creation tres simples, comme HTML Kit, obligent le programmeur a 
voir en permanence les elements HTML utilises. Un bon compromis consiste a utiliser 
un editeur WYSIWYG pour creer le design et la mise en page generale des pages Web 
puis de recuperer le fichier XHTML realise dans un editeur PHP specialise afin d'effec- 
tuer les tests facilement apres avoir installe le serveur local PHP. 

Le tableau 1-1 presente une liste d'outils de developpement de scripts. 

Tableau 1-1 - Editeurs HTML et PHP 



Produit 


Statut 


Description 


Adresse 


HTML Kit 


Gratuit 


Editeur HTML 


http-.llwww. chami. com 


EditPlus 


Shareware 


Editeur XHTML permettant I'ecriture 
et I'execution de scripts PHP 


http:/lwww. editplus.com 


Maguma Studio 


Version freeware 
ou payante 


Editeur HTML permettant I'ecriture et 
I'execution de scripts PHP dans votre 
navigateur. Aide a la saisie des fonc- 
tions 


http:llwww. maguma.com 


NuSphere 


Payant 


Idem, mais comporte une bonne aide 
syntaxique 


http-.llwww. nusphere. com 


WebExpert 


Payant 


La version 6 permet I'ecriture et I'exe- 
cution faciles de scripts PHP 


http:llsoftware.visicommedia.com/fr/ 



Installation d'un serveur local 

Faute de disposer d'un serveur local sur votre ordinateur personnel, vous seriez oblige 
pour tester vos pages PHP de les transferer sur le serveur distant de votre hebergeur puis 
d'appeler ces pages en vous connectant au site a l'aide de votre navigateur. La moindre 
erreur de code ou la moindre modification vous obligerait a repeter toute cette procedure, 
d'ou une importante perte de temps. 

II est done indispensable d'installer sur votre poste de travail un serveur local simulant 
votre serveur distant et vous permettant d'effectuer en direct tous les tests desires. Vous 
aurez alors dans votre navigateur exactement le meme aspect pour toutes ces pages que 
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les visiteurs de votre site quand vous aurez opere le transfert de vos fichiers sur le serveur 
distant qui l'hebergera. 

Le serveur local comprend les elements suivants, disponibles separement aux adresses 
entre parentheses : 

• Serveur Apache (http://www.apache.org). 

• Interpreteur de code PHP (http://www.php.net). 

• Base de donnees MySQL (http://www.mysql.com). 

• Base de donnees SQLite (http://www.sqlite.org). 

• Utilitaire phpMy Admin, qui permet de creer et de gerer bases et tables de donnees 

MySQL(http://www.phpmyadmin.net). 

• Utilitaire SQLiteManager, qui permet de creer et de gerer bases et tables de donnees 
S QLite (http://www.sqlitemanager. org) . 

On peut trouver sur le Web divers packages complets pour Windows, Linux ou Mac, qui 
permettent d' installer en une seule operation tous ces elements, evitant du me me coup les 
problemes de configuration. 

Un installeur est apparu a l'occasion de la sortie de PHP 5. Son auteur, Romain Bourdon, 
se montre tres reactif en publiant une nouvelle version a chaque evolution. Son package, 
nomme Wampserver, telechargeable a l'adresse http://www.wampserver.com, est destine aux 
ordinateurs sous Windows. 

Une fois la procedure de telechargement terminee, il vous suffit de lancer l'executable 
WampServer2.0b.exe, qui installe automatiquement Apache, PHP, MySQL, SQLite 
phpMy Admin et SQLitemanager sur votre ordinateur. Si, pendant la phase d'installation, 
vous avez choisi d'installer PHP en tant que service Windows, le serveur est lance auto- 
matiquement a chaque demarrage du systeme d'exploitation. 
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@ Localhost 
P] phpMyAdrmin 
SQLiteManager 
\r~) www directory 
Q Apache 
PHP 
" MySQL 
D 




HE 



Start All Services 
Stop All Services 
Restart All Services 



Put Online 




Figure 1-1 

L'icone de Wampserver et les options d 'administration 
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La figure 1-1 montre l'icone de Wampserver 2.0 telle qu'elle figurera sur votre Bureau 
Windows et le menu d' administration qui apparait quand vous cliquez sur l'icone de 
lancement rapide ressemblant a un demi-cercle gradue. 

Si vous avez realise l'installation dans le dossier C:\wamp, vous obtenez l'arborescence 
illustree a la figure 1-2. 



B Q wannp 
Ir^ alias 
B IS) apps 
B IS) bin 
Ir^ help 
B IS) lang 
IS) logs 
lS) scripts 
IS) tmp 
B IS) www 

lS) chapl 
IS) chap2 
lS) chap3 
lS) chap4 

Figure 1-2 

Arborescence du dossier d' installation de Wampserver 



Pour pouvoir etre executes par le serveur local, tous les scripts que vous ecrivez doivent etre 
enregistres dans le sous-dossier www. Dans ce dernier, vous pouvez creer un ou plusieurs 
sous-dossiers correspondant a chaque site que vous voulez tester (voir la figure 1-2). Au 
prochain lancement du serveur, ils apparaitront dans la page d'accueil de Wampserver 
dans la rubrique « vos projets » (voir figure 1-3). 

La page d' administration du serveur local vous donne acces a differents parametres, tels 
que 1' acces a la page d'accueil de Wampserver en cliquant sur « localhost », ou 1' acces 
direct a phpMy Admin ou SQLiteManager pour gerer vos bases de donnees. 

La figure 1-3 montre la page d'accueil de Wampserver. Elle peut egalement etre obtenue 
si vous entrez dans votre navigateur l'adresse http://localhost. 



Linux et Mac OS 

Pour les partisans de Linux, il existe une version d'un installeur de serveur local nomme LAMP a l'adresse 

http://doc.ubuntu-fr.org/lamp 

Les amateurs de Mac OS en trouveront un equivalent nomme MAMP a l'adresse http://www.mamp.info/ 

en/index.php. 
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Premier contact avec PHP 

Etant desormais dote de tous les outils necessaires, vous pouvez aborder le fonctionne- 
ment de PHP et les differentes methodes de travail que vous devrez utiliser par la suite. 

Organisation de PHP 

PHP ne repose pas sur une hierarchie de classes regroupees en sous-ensembles (name- 
space), comme ASP.Net ou Java, mais sur des modules. Le module de base, dit standard, 
permet d'acceder aux instructions elementaires, aux differents types de donnees et a un 
grand nombre de fonctions. Des modules additionnels specialises permettent d'ajouter 
des fonctionnalites particulieres, comme l'acces aux diverses bases de donnees et leur 
gestion. Chaque module donne acces a un grand nombre de fonctions specialisees pour 
un domaine particulier. 

La liste des modules disponibles actuellement est visible dans la documentation generale 
du langage sur le site officiel de PHP, a l'adresse http://www.php.net. 

Vous pouvez telecharger sur le meme site la documentation officielle de PHP, qui donne, 
y compris en francais, la definition de toutes les fonctions existantes. Le document 
compte quelque deux mille pages au format Acrobat PDF. 

Pour savoir quels modules vous pouvez utiliser sur votre serveur local, il vous suffit de 
cliquer sur le lien phpi nfo( ) de la page d'accueil de votre serveur local Wampserver (voir 
figure 1-3). 
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Figure 1-3 

Page d' administration du serveur local Apache PHP MySQL 
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Pour obtenir la meme information pour le serveur qui heberge votre site, procedez de la 
facon suivante : 

1. Ecrivez le script PHP suivant, d'une simplicite enfantine (vous n'en ecrirez jamais 
d'aussi court donnant autant d'informations), a l'aide de l'editeur que vous avez choisi : 

|<?php 
phpinfo( ) ; 
?> 

2. Enregistrez le script sous le nom 1 nf o . php. Sous PHP, tous les scripts commencent par 
la ligne <?php et se terminent par ?>. Notez que, sauf recommandation speciale de votre 
hebergeur, tous les fichiers qui contiennent des instructions PHP sont enregistres avec 
l'extension .php. Les extensions .php3, .php4, .php5ou .phtml se rencontrent sur certains 
serveurs, suivant la configuration effectuee par l'administrateur. 

3. Transferez le fichier info. php sur votre serveur distant a l'aide d'un logiciel FTP. 
Si vous n'en avez pas, vous pouvez telecharger FileZilla, un logiciel gratuit, dont 
le fonctionnement est aussi simple que convivial, a l'adresse http://www.sourceforge.net/ 
projects/filezilla. 

4. Saisissez l'adresse http://www.votresite.com/info.php dans votre navigateur. 

Un grand nombre d'informations utiles concernant votre serveur et l'ensemble des 
modules qui y sont installed apparaissent alors (voir figure 1-4). 
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Figure 1-4 

Informations concernant le serveur fournies par phpinfof ) 
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II est recommande d'imprimer ces informations et de les conserver precieusement car 
elles vous permettront de determiner, au moment oil vous en aurez besoin, si vous pouvez 
utiliser tel ou tel module ou fonction. II serait dommage de travailler des heures a creer 
un script qui utilise des fonctions utilisables en local mais non disponibles sur votre 
serveur distant. 



Structure des fichiers XHTML 

Comme explique precedemment, la connaissance du langage XHTML est utile pour se 
lancer dans l'ecriture de scripts PHP. II est done utile de connaitre la structure des fichiers 
XHTML car une page dynamique PHP est bien un document XHTML envoye par le 
serveur vers le poste client. 

Pour etre conforme aux recommandations XHTML du W3C (http:// www.w3.org), un docu- 
ment XHTML doit avoir la structure suivante (fichier pagexhtml . html ) : 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Titre de la page</title> 
</head> 
<body> 

<h2>Bienvenue sur le site PHP 5 </h2> 
</body> 
</html> 

Cette page primaire est ecrite en XHTML pur, et tous les visiteurs de votre site verront 
exactement le meme contenu, quel que soit le moment de leur connexion. Le fichier peut 
avoir l'extension .html ou .htm car il ne contient que du code XHTML, mais il pourrait 
tout aussi bien avoir une extension .php et avoir le meme rendu dans un navigateur. 

Vous pourriez lui apporter un brin de dynamisme en affichant la date du jour en tete de 
page a l'aide du code PHP suivant (fichier codephp.php) : 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :1 ang="fr"> 



<head> 

<meta http-equi v="Content-Type" content="text/html ; 

<title>Une page PHP</title> 
</head> 
<body> 

<?php 

echo "<h3> Aujourd'hui le ". date('d / M / 
echo "<h2>Bienvenue sur le site PHP 5</h2>' 

?> 
</body> 



charset=iso-8859-l" /> 



Y H:m:s')."</h3Xhr />"; 
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</html> 

Le code de votre nouvelle page contient les nouveaux elements suivants, qui ne sont pas 
du XHTML : 



<?php 

echo "<h3> Aujourd'hui le ' 

echo "<h2>Bienvenue sur le 

?> 



. dateCd / M / Y H:m:s 
site PHP 5</h2>"; 



)."</ h3Xhr />"; 



Les elements <?php et ?> marquent respectivement le debut et la fin de tout script PHP, 
qu'il soit inclus dans du code HTML ou isole dans un fichier ne contenant que du code 
PHP. Vous pouvez inclure autant de blocs de code PHP que vous le desirez dans un docu- 
ment HTML, a condition que chacun d'eux soit delimite par ces marqueurs. 

Entre ces elements figure le code PHP proprement dit : 

I echo "<h3> Aujourd'hui le ". dateCd / M / Y H:m:s' )."</ h3Xhr />"; 
echo "<h2>Bienvenue sur le site PHP 5</h2>"; 

L'instruction echo permet d'ecrire dans le document final le contenu qui la suit, que ce 
soit du texte ou le resultat retourne par une fonction, comme dans les deux lignes prece- 
dentes. Notez que les lignes de code PHP se terminent toujours par un point- virgule. 

Si vous recopiez et executez ce fichier dans votre navigateur, vous obtenez le resultat 
illustre a la figure 1-5, qui donne un apercu de ce qu'est une page dynamique elemen- 
taire. Vous pourriez faire la meme chose a l'aide d'un script JavaScript execute non pas 
sur le serveur mais par le navigateur du poste client. La difference est que la date et 
l'heure affichees ici sont celles du serveur et pas celle de votre ordinate ur, comme le 
ferait JavaScript. L'un des avantages de PHP est cependant que vous n'avez pas a tenir 
compte des capacites du navigateur du visiteur. 
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Figure 1-5 

Resultat de votre premiere page PHP 
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Examinez maintenant le code source du document tel qu'il a ete recu par le navigateur. 
Dans Firefox, par exemple, allez dans le menu Affichage>Source de la page. Le code 
suivant s'affiche : 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 
<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Une page PHP</title> 
</head> 
<body> 
<h3> Aujourd'hui le 24 / Sep / 2008 ll:09:26</h3Xhr /> 
<h2>Bienvenue sur le site PHP 5</h2> 
</body> 
</html> 

Par rapport au code du flchier codephp.php, ce qui etait contenu entre les elements <?php 
et ?>, soit : 

<?php 

echo "<h3> Aujourd'hui le ". dateCd / M / Y H:m:s ')."</h3Xhr />"; 

echo "<h2>Bienvenue sur le site PHP 5</h2>"; 

?> 

a ete remplace par : 

|<h3> Aujourd'hui le 24 / Sep / 2008 11:09:26</ h3Xhr /> 
<h2>Bienvenue sur le site PHP 5</h2> 

L'interpreteur PHP analyse le document dans son ensemble puis renvoie le code XHTML 
tel quel, accompagne de 1'evaluation des expressions contenues dans le code PHP. Cela 
fait d'ailleurs dire a certains que tout est expression dans PHP puisque tout le code peut 
etre evalue comme une chaine de caracteres, un nombre ou une valeur booleenne. 

Les parties de code contenues dans les guillemets sont renvoyees dans le flux du docu- 
ment XHTML, et les balises qu'elles contiennent sont interpreters en tant que telles par 
le navigateur. C'est le cas de la deuxieme ligne. La premiere ligne comporte une fonction 
PHP qui retourne la date du jour. Cette date est concatenee avec le texte qui l'entoure 
puis est retournee au navigateur. 

Le cycle de vie d'une page PHP est le suivant : 

• Envoi d'une requete HTTP par le navigateur client vers le serveur, du type 

http://www.monserveur.com/codephp.php. 

• Interpretation par le serveur du code PHP contenu dans la page appelee. 

• Envoi par le serveur d'un fichier dont le contenu est purement XHTML. 

Vous constatez ainsi que votre code PHP n'est jamais visible par les visiteurs de votre site. 
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Ecriture du code PHP 

Le code PHP est toujours incorpore dans du code XHTML. Vous pouvez done incorporer 
autant de scripts PHP independants que vous le souhaitez n'importe ou dans du code 
XHTML, du moment que ces parties sont delimitees par les balises ouvrantes et fermantes 
<?php et "?>" (reperes O- 0> ©> et O) ou P ar l a forme courte <?= et ?> (reperes et 
0) ou encore par l'element XHTML <script language="php"> (repere 0), qui est rare- 
ment employe. 

Dans un fichier . php, vous pouvez a tout moment passer du code PHP au code XHTML, 
et reciproquement. C'est ce qui donne sa grande souplesse d'utilisation a ce code. 

Le listing suivant illustre cette particularite : 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<?php<-0 

$variablel=" PHP 5"; 
?> 

<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<?php ^0 

echo "<title>Une page pleine de scripts PHP</title>" ; 
?> 

</head> 
<body> 
<script language="php"> <— 

echo"<hl>B0NJ0UR A TOUS </hl>"; 
</script> 
<?php ^0 

echo "<h2> Titre ecrit par PHP</h2>"; 

$variable2=" MySQL"; 
?> 

<p>Vous allez decouvrir <?= Svariablel ?> <— ©</p> 
<?php<-0 

echo "<h2> Bonjour de $variablel</h2>" ; 
?> 
<p>Utilisation de variables PHP<br />Vous allez decouvrir egalement 

<?php <-Q 

echo $variable2 

?> 
</p> 

<?= "<div><big>Bonjour de $variable2 </big></div>" ?> <— 
</body> 
</html> 

Huit mini-scripts PHP sont places aussi bien dans l'en-tete (entre <head> et </head>) que 
dans le corps (entre <body> et </body>) ou encore meme en dehors du bloc delimite par les 
elements <html > et </html > du document XHTML. 
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Certains de ces scripts interviennent comme contenu d'un element XHTML avec une 
syntaxe particuliere. Par exemple : 

<?= Svariablel ?> 

peut etre utilise pour des instructions courtes. II est equivalent a : 

<?php echo $variablel ?>. 

Attention, pour utiliser cette notation il faut que la directive short open tag soit activee 
dans le fichier de configuration de PHP 5 (le fichier php.ini). A partir de ce document, 
vous obtenez le resultat illustre a la figure 1-6. 



Uiit? page pleine de sci JijEs PHP - Mozilid Firefej; 



Fidhier EdJion Afffchage Historique Marque-pages Ouftils ? 



BE® 



- C f& ( Q |htWJnati«t/diaplfrtM2.|i(ip Y^\ |Eh& 

BONJOURATOUS 

Titre ecrit pur PHF' 

Vous allc^ dccouvrirPUP 5 

Bonjour de PHP 5 

Utilisation de variables PHF 

Vous allez decouwir e^alement MySQL 

Bonjour de MySQL 



Figure 1-6 

Resultat des mini-scripts 



Comme precedemment, la consultation du code source dans le navigateur montrerait que 
le resultat de chaque mini-script est purement XHTML et qu'aucun code PHP ne 
subsiste. 

Inclure des fichiers externes 

Comme en JavaScript, il est possible d'ecrire du code PHP ou XHTML dans des fichiers 
separes puis de les incorporer dans du code XHTML ou d'autres scripts PHP en fonction 
des besoins. Cela peut constituer un debut de modularisation du code, permettant d'ecrire 
une seule fois certaines parties de code et de les reutiliser dans plusieurs pages differentes, 
avec economie de temps. Cette possibilite permet notamment de creer une bibliotheque 
de fonctions d'utilisation courante. 
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On donne generalement aux fichiers de code PHP l'extension .inc ou .inc.php, cette 
derniere ayant l'avantage de proteger les donnees confidentielles que peut contenir le 
code, comme les parametres de connexion a la base de donnees (login et mot de passe). 
Le contenu du fichier est interprete par le serveur. Si le fichier ne contient que vos para- 
metres dans des variables, le serveur ne renvoie rien au poste client si quelqu'un tente de 
l'executer, alors qu'un navigateur afflche le contenu d'un fichier avec l'extension . i nc seule. 

Pour inclure le contenu d'un fichier externe dans du code PHP, vous disposez des fonc- 
tions recensees au tableau 1-2. 

Tableau 1-2 - Fonctions d'inclusion de code externe 

Fonction Description 

include("nom_fichier.ext") Lors de son interpretation par le serveur, cette ligne est remplacee par 

tout le contenu du fichier precise en parametre, dont vous fournissez le 
nom et eventuellement I'adresse complete. En cas d'erreur, par exemple 
si le fichier n'est pas trouve, incl ude( ) ne genere qu'une alerte, et le 
script continue. 

require("nom_fichier.ext") A desormais un comportement identique a includeO. a la difference 

pres qu'en cas d'erreur, requi ret ) provoque une erreur fatale et met fin 
au script. 

include_once("nom_fichier.ext") Contrairement aux deux precedentes, ces fonctions ne sont pas execu- 

require_once("nom_fichier.ext") tees plusieurs fois, meme si elles figurent dans uneboucleou siellesont 

deja ete executees une fois dans le code qui precede. 
I I 

L'exemple suivant utilise les possibilites d'inclusion fournies par ces fonctions pour 
creer une page XHTML a partir de quatre fichiers independants. II s'agit d'un debut de 
modularisation du code d'un site. Notre hypothese est que chaque page du site a le meme 
en-tete et le meme pied de page et que chacune des pages ne differe des autres que par 
son contenu. 

L'exemple comprend les fichiers suivants : 

• tete. inc.php. Contient le debut du code XHTML d'une page normale (<html>, <head>, 
<body>) et trois petits scripts PHP. Le dernier de ces scripts (repere Q) affiche le 
bandeau commun a toutes les pages (repere ©) ainsi que le nom du fichier execute et 
celui du fichier inclus (repere ©). 

• corps . i nc . php. Ne contient que du code PHP affichant deux lignes de texte (repere ©). 

• corps . html . Ne contient que du code XHTML affichant deux lignes de texte (repere ©). 

• pied. inc. php. Contient un script affichant un bandeau de pied de page et deux liens 
vers des sites dignes d'interet (repere ©). 

• principal .php. Script utilisant les quatre precedents a l'aide des fonctions includeO 
(repere Q), include_once( ) (repere©), requi re() (repere©) et requi re_once() 
(repere ©). C'est le seul qui doive etre appele directement. Les autres fichiers n'etant 
que des composants, ils ne doivent normalement pas etre utilises seuls. 
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La figure 1-7 donne un apercu du resultat obtenu. 

Exemple 1-1 . Inclusion de fichiers externes 

Le fichier tete . 1 nc . php : 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 

<?php 
$variablel=" PHP 5"; 

?> 

<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 

<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<?php 

echo "<title>Une page pleine d'inclusions $variablel</title>" ; 

?> 

</head> 

<body> 

<?php ^O 

$variableext="Ce texte provient du fichier inclus"; 

echo "<div><hl style=\"border-width:5;border-style:double; 

*» background- col or :#ffcc99;\"> 

Bienvenue sur le site $variablel </hl>";<— © 

echo "<h3> $variableext</h3>" ; 

$_SERVER['PHP_SELF']." &nbsp: ": <-© 
, FILE ,"</div> "; <-© 



echo "Norn du fichier execute: 
echo " Nom du fichier inclus 
?> 



Le fichier corps . i nc . php : 

<?php 

echo "<hl> Ceci est le corps du document </hl>";<— Q 

echo "<h2> Ceci est le corps du document </h2>"; 

?> 

Lefichiercorps.html : 

I< h 1 > Ceci est le corps du document : Avec PHP on progresse vite et avec MySQL le 
**site devient vite tres dynamique </hl> 
<h2> On s'y met tout de suite!!!! </h2><— 

Le fichier pied. inc. php : 

<hr /> 

<?php 

echo "<div><hl style=\"border-width:3;border-style:groove; background-color: 

^»#ffcc99;\"> Fin de la page PHP Liens utiles : <a href=\"php.net\">php.net</a> 

*  <a href=\"mysql .org\">mysql .org</a></hl>" ; <— © 

echo "Nom du fichier execute: ", $_SERVER[' PHP_SELF' ] , "    " ; 

echo "Nom du fichier inclus: ", FILE ,"</div>"; 

?> 

</body> 

</html> 
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Le fichier principal .php : 

<?php 

incl udeC'tete.inc.php" ) ; <— O 

echo "<hr />"; 

incl ude_once(" corps. inc. php") ; <— © 

requi re( "corps . html " ) ; <— © 

require_once( "pied. inc. php" ) ; <— © 

?> 



Fichier Edition Affictage Historiquc Marque pages Q-utils J 

K9 * O f£> ( Li | hnpc/yinralhiMt/r hApl/prinrifuLphp 



Id- 



Bienvenue sur le site PHP 5 



Ce teste proilent du ficliiei inclus 

"Xnm rfi] firhipr pxpnitp. ■rhapl principal php Norn rill firhipr inrlm ■ O'.wjwnp'www'rhapl MP mc php 

Ceci est le corps du document 

Ceci est lc corps du document 

Ceri etf 1p rnip^ rin rtoriimpnr : Av*r PHP nn prn£»^p vitp er itvpt MySQT. Ip "iftp dpvienT vitp rrp<; rlynamiqiip 

On s'y met tout de suite!!!! 



Fin de la page PHP Liens utiles : php.net niysql.org 



Norn du fichier execute: chapl principal. php iNom du iichier inclus: C'z'wamp www chap 1 pied.iac.pbp 



J 



Figure 1-7 

Unpage composee defichiers inclus 

Ajout de commentaires 

II est toujours utile de commenter les scripts que vous ecrivez. Lors de l'ecriture, tout peut 
paraitre evident, mais a la relecture, plusieurs mois plus tard, lorsqu'il s'agit d'effectuer 
des mises a jour, par exemple, autant eviter de perdre du temps a redecouvrir la logique 
adoptee auparavant. 

Les commentaires ne sont pas pris en compte par l'analyseur PHP. S'ils alourdissent un 
peu le fichier PHP en terme d'octets sur le serveur, ils ne sont pas presents dans le code 
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XHTML renvoye au navigateur client. Leur poids est done sans importance pour la rapi- 
dite de transmission des pages. 

PHP supporte les trois syntaxes de commentaires suivantes : 

• commentaires sur une seule ligne introduits par les caracteres // : 

| //ceci est un commentaire court sur une ligne 

• commentaires sur plusieurs lignes introduits par les caracteres / * et fermes par les 
caracteres */ : 

I/* Ceci est commentaire abondant 
qui va occuper plusieurs lignes 
et va expliquer le code qui suit */ 

• commentaires de type UNIX, ne comportant qu'une seule ligne introduite par le carac- 
tere # : 

# commentaires de type UNIX 
jt*************************************** 



2 



Variables, constantes et types 



Comme tout langage, PHP manipule des donnees. Pour un site dynamique, ces donnees 
sont variables. De plus, elles peuvent etre de types differents, tel du texte sous forme de 
chaine de caracteres, comme vous en avez utilise avec 1' instruction echo, sous forme de 
nombres entiers ou decimaux ou encore sous forme de valeurs booleennes vrai ou faux 
(TRUE ou FALSE). Ces types de base sont les plus employes, mais il en existe d'autres, qui 
peuvent etre des types composes, comme les tableaux et les objets, ou des types particu- 
liers, comme resource ou NULL. 



Les variables 



Une variable est le conteneur d'une valeur d'un des types utilises par PHP (entiers, flot- 
tants, chaines de caracteres, tableaux, booleens, objets, ressource ou NULL). 

Chaque variable possede un identifiant particulier, qui commence toujours par le carac- 
tere dollar ($) suivi du nom de la variable. Les regies de creation des noms de variable 
sont les suivantes : 

• Le nom commence par un caractere alphabetique, pris dans les ensembles [a-z], [A-Z] 
ou par le caractere de soulignement (_). 

• Les caracteres suivants peuvent etre les memes plus des chiffres. 

• La longueur du nom n'est pas limitee, mais il convient d'etre raisonnable sous peine 
de confusion dans la saisie du code. II est conseille de creer des noms de variable le 
plus « parlant » possible. En relisant le code contenant la variable $nomclient, par 
exemple, vous comprenez davantage ce que vous manipulez que si vous aviez ecrit $x 
ou $y. 
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• La declaration des variables n'est pas obligatoire en debut de script. C'est la une 
difference notable avec les langages fortement types comme Java ou C. Vous pouvez 
creer des variables n'importe ou, a condition bien stir de les creer avant de les utili- 
ses meme s'il reste possible d'appeler une variable qui n'existe pas sans provoquer 
d'erreur. 

• L'initialisation des variables n'est pas non plus obligatoire et une variable non initiali- 
see n'a pas de type precis. 

• Les noms des variables sont sensibles a la casse (majuscules et minuscules). $mavar et 
$MaVar ne designent done pas la meme variable. 

Les noms de variables suivants sont legaux : 

Smavar 

$_mavar 

$mavar2 

$M1 

$_123 

Les suivants sont illegaux : 

|$5mamar 
$*mavar 
$mavar+ 

Affectation par valeur et par reference 

L'affectation consiste a donner une valeur a une variable. Comme explique precedem- 
ment, lors de la creation d'une variable, vous ne declarez pas son type. C'est la valeur 
que vous lui affectez qui determine ce type. Dans PHP, vous pouvez affecter une variable 
par valeur ou par reference. Vous verrez que les methodes et les consequences de ces 
deux types d' affectation sont differentes et peuvent amener des resultats inattendus, si 
vous n'y prenez garde. 

L'affectation par valeur se fait a l'aide de l'operateur =, soit apres la creation de la varia- 
ble, soit en meme temps. 

Dans l'exemple suivant : 

Smavar = expression; 

la variable Smavar prend la valeur de l'expression, qui peut etre une valeur numerique, par 
exemple, une chaine de caracteres litterale, mais aussi une autre variable ou encore une 
expression PHP valide contenant des fonctions. 

Dans les affectations suivantes : 

$mavar=75; 

$mavar="Paris" ; 

$mavar=7*3+2/5-91%7; //PHP evalue l'expression puis affecte le resultat 

$mavar=mysql_connect($a,$b,$c) ; //la fonction retourne une ressource 

$mavar=isset($var&&($var==9) ) ; //la fonction retourne une valeur booleenne 
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remarquez l'utilisation du meme nom de variable alors que les valeurs affectees sont de 
type different. 

Dans l'affectation par valeur a l'aide de l'operateur =, l'operande de gauche, c'est-a-dire 
la variable a affecter, prend la valeur de 1' expression contenue dans l'operande de droite, 
et voila tout. Toute modification ulterieure de l'operande de droite, meme s'il est lui- 
meme une variable, n'a aucune incidence sur la variable affectee. 

Dans l'exemple suivant : 

$mavarl="Paris" ; 
Smavar2="Lyon"; 
$mavar2=$mavarl; 
$mavarl="Nantes" ; 

a la fin du code, la variable $mavar2 contient la chaine "Paris", puisque vous lui avez 
affecte la valeur de l'expression Smavarl, et $mavarl vaut "Nantes", puisque sa valeur a ete 
modifiee a la fin du script. 

Avec l'affectation par reference, toujours realisee au moyen de l'operateur =, l'operande 
de droite est une variable qui doit etre precedee du caractere & (esperluette). 

Dans l'exemple suivant : 

$mavarl="Paris" ; 
$mavar2="Lyon" ; 
$mavar2 = &$mavarl; 
$mavarl="Nantes" ; 

la variable $mavar2 devient un alias de la variable Smavarl, et les modifications operees sur 
Smavarl sont repercutees sur $mavar2. Plus deroutant encore pour le novice, et plus dange- 
reux aussi, toute modification apportee a la valeur de $mavar2 est repercutee dans Smavarl 
puisque $mavar2 est un alias de Smavarl. C'est ce qu'illustre le script de l'exemple 2-1. 

Exemple 2-1 . Affectation par valeur et par reference 

<?php 

//Affectation par valeur de Smavarl et Smavar2 

Smavarl="Paris" ; 

echo "\Smavarl= ", Smavarl, "<br />"; 

Smavar2="Lyon"; 

echo "\Smavar2= " ,Smavar2, "<br />"; 

//Affectation par reference de Smavar2 

Smavar2 = &$mavarl; 

echo "Affectation par reference de \$mavar2 <br />"; 

echo "\Smavarl= " .Smavarl, "<br />"; 

echo "\Smavar2= " ,Smavar2, "<br />"; 

echo "modification de \$mavarl <br />"; 

Smavarl="Nantes" ; 

echo "\Smavarl= " .Smavarl, "<br />"; 

echo "\Smavar2= " ,Smavar2, "<br />"; 

echo "modification de \Smavar2 <br />"; 

Smavar2="Marseil le" ; 
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echo "\$mavarl= 
echo "\$mavar2= 
?> 



,$mavarl,"<br />"; 
,$mavar2,"<br />"; 



Le resultat de l'execution de ce script montre revolution des valeurs des deux variables 
apres plusieurs affectations. 



$mavarl= Paris 




$mavar2= Lyon 




affectation par 


reference de $mavar2 


$mavarl= Paris 




$mavar2= Paris 




modification de 


Smavarl 


$mavarl= Nantes 




$mavar2= Nantes 




modification de 


$mavar2 


$mavarl= Marsei" 


le 


$mavar2= Marsei" 


le 



Lorsque vous utilisez ce type d' affectation, il est important de ne pas oublier ses effets en 
cours de script car chacune de ces deux variables change de valeur de maniere sous- 
jacente chaque fois que vous intervenez sur l'autre, sans que la modification soit explici- 
tement ecrite. 

Les variables predefinies 

PHP dispose d'un grand nombre de variables predefinies, qui contiennent des informa- 
tions a la fois sur le serveur et sur toutes les donnees qui peuvent transiter entre le poste 
client et le serveur, comme les valeurs saisies dans un formulaire (voir le chapitre 6), les 
cookies ou les sessions (voir le chapitre 13). 

Depuis PHP 4.1, ces variables se presentent sous la forme de tableaux, accessibles en 
tout point de n'importe quel script. On appelle ces tableaux superglobaux. Le tableau 2-1 
donne une breve description de ces variables sans en detailler le contenu car un certain 
nombre d' entre elles ne presentent pas un interet pratique immediat. Vous aurez toute 
precision necessaire sur leur utilisation a mesure que vous les utiliserez dans le cours de 
l'ouvrage. Reportez-vous a la section concernant les tableaux pour lire le contenu de ces 
variables. 

Tableau 2-1 - Les variables serveur PHP 



$GL0BALS Contient le nom et la valeur de toutes les variables globales du script. Les noms des variables sont 

les cles de ce tableau. 

$GLOBALS["mavar"] recupere la valeur de la variable Smavar en dehors de sa zone de visibility 
(dans les fonctions, par exemple). 

$_C00KI E Contient le nom et la valeur des cookies enregistres sur le poste client. Les noms des cookies sont 

les cles de ce tableau (voir le chapitre 13). 
Avant PHP 4.1, cette variable se nommait $HTTP_COOKIES_VARS. 
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Tableau 2-1 - Les variables serveur PHP (suite) 

$_ENV Contient le nom et la valeur des variables d'environnement qui sont changeantes selon les serveurs. 

Avant PHP 4.1, cette variable se nommait $HTTP_ENV_VARS. 

$_FI LES Contient le nom des fichiers telecharges a partir du poste client. 

Avant PHP 4.1, cette variable se nommait $HTTP_FILES_VARS. 



$_GET Contient le nom et la valeur des donnees issues d'un formulaire envoye par la methode GET. Les 

noms des champs du formulaire sont les cles de ce tableau (voir le chapitre 6). 
Avant PHP 4.1, cette variable se nommait $HTTP_GET_VARS. 

$_P0ST Contient le nom et la valeur des donnees issues d'un formulaire envoye par la methode POST. Les 

noms des champs du formulaire sont les cles de ce tableau. 
Avant PHP 4.1 , cette variable se nommait $HTTP_POST_VARS. 

$_REQUEST Contient I'ensemble des variables superglobales $_GET, $_P0ST, $_C00KIE et $_FI LES. 

Avant PHP 4.1 , cette variable n'existait pas. 

$_SERVER Contient les informations liees au serveur Web, tel le contenu des en-tetes HTTP ou le nom du 

script en cours d'execution. Retenons les variables suivantes : 

$_SERVER["HTTP_ACCEPT_LANGUAGE"], qui contient le code de langue du navigateur client. 
$_SERVER["HTTP_COOKIE"], qui contient le nom et la valeur des cookies lus sur le poste client. 
$_SERVER["HTTP_HOST"], qui donne le nom de domaine. 
$_SERVER["SERVER_ADDR"], qui indique I'adresse IP du serveur. 

$_SERVER["PHP_SELF"], qui contient le nom du script en cours. Nous I'utiliserons souvent dans 
les formulaires. 
$_SERVER["QUERY_STRING"], qui contient la chaine de la requete utilisee pour accederau script. 

$_SESSI0N Contient I'ensemble des noms des variables de session et leurs valeurs. 



Les operateurs d 'affectation combinee 

En plus de l'operateur classique d' affectation =, il existe plusieurs operateurs d' affecta- 
tion combinee. Ces operateurs realisent a la fois une operation entre deux operandes et 
1' affectation du resultat a l'operande de gauche. 

Le tableau 2-2 decrit I'ensemble de ces operateurs. 

Tableau 2-2 - Les operateurs d'affectation combinee 
Operateur Description 



Addition puis affectation : 

$x += $y equivaut a $x = $x + $y 

$y peut etre une expression complexe dont la valeur est un nombre. 

Soustraction puis affectation : 

$x -= $y equivaut a $x = $x - $y 

$y peut etre une expression complexe dont la valeur est un nombre. 

Multiplication puis affectation : 

$x *= $y equivaut a $x = $x * $y 

$y peut etre une expression complexe dont la valeur est un nombre. 
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Tableau 2-2 - Les ope rate urs d'affectation combinee (suite) 



/= 


Division puis affectation : 




$x /- $y equivaut a $x = $x / $y 




$y peut etre une expression complexe dont la valeur est un nombre different de 0. 


%= 


Modulo puis affectation : 




$x %= $y equivaut a $x = $x % $y 




$y peut etre une expression complexe dont la valeur est un nombre. 


.= 


Concatenation puis affectation : 




$x .= $y equivaut a $x = $x . $y 




$y peut etre une expression litterale dont la valeur est une chaine de caracteres. 



Les constantes 

Vous serez parfois amene a utiliser de maniere repetitive des informations devant rester 
constantes dans toutes les pages d'un meme site. II peut s'agir de texte ou de nombres qui 
reviennent souvent. Pour ne pas risquer l'ecrasement accidentel de ces valeurs, qui pour- 
rait se produire si elles etaient contenues dans des variables, vous avez tout interet a les 
enregistrer sous forme de constantes personnalisees. 

PHP dispose d'un ensemble de constantes predefinies utilisables dans tous les scripts. 

Definir ses constantes personnalisees 

Pour definir des constantes personnalisees, utilisez la fonction define 0, dont la syntaxe 
est la suivante : 

boolean define(string nom_cte, divers valeur_cte, boolean casse) 

Dans cet exemple, vous attribuez la valeur valeur_cte a la constante nominee nom_cte, 
dont le nom doit etre contenu dans une chaine de caracteres delimitee par des guillemets. 
Le parametre casse vaut TRUE si le nom de la constante est insensible a la casse et FALSE 
sinon. La fonction def i neO retourne TRUE si la constante a bien ete definie et FALSE en cas 
de probleme, par exemple, si vous essayez de redefinir une constante existante, ce qui est 
interdit. Toute tentative de modifier la valeur d'une constante en la redefinissant provo- 
que un avertissement (warning) de la part du serveur. 



Attention 

Une constante n'etant pas precedee du signe dollar ($), vous ne pouvez I'incorporer telle quelle dans une 
chaine comme vous le faites avec les variables. II vous faut done la concatener avec une chaine ou la 
separer de ce qui precede par une virgule dans I'instruction echo. 



La fonction defined(string nonucte) permet de verifier si une constante nominee existe. 
Elle retourne TRUE si la constante nommee nom_cte existe et FALSE sinon. Cette verification 
peut etre utile, car il est impossible de declarer deux constantes de meme nom. 
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Exemple 2-2. Creation et lecture de constantes 



<?php 

//definition insensible a la casse 

defineC PI ",3.1415926535, TRUE); ^© 

//Util isation 

echo "La constante PI vaut ",PI,"<br />"; 

echo "La constante PI vaut ",pi,"<br />"; 

//Verification de 1 'existence 

if (definedt "PI")) echo "La constante PI est deja definie" 

if (defined( "pi")) echo "La constante pi est deja definie" 

//definition sensible a la casse, verification de 1 'existence et utilisation 

if (define ("site" , "http://www.funhtml .com" .FALSE) ) <— © 



,"<br />" 
,"<br />" 



echo "<a href=\" " .site, " \">Lien vers mon site </ a>"; 



?> 



La constante PI etant declaree insensible a la casse (repere :i - e U e P eut etre utilisee sous 
la forme PI ou pi ou encore Pi ou toute autre variante. Par contre, la constante site est 
declaree sensible a la casse (repere ©) et ne peut etre utilisee qu'en minuscules. 



Les constantes predefinies 

II existe dans PHP un grand nombre de constantes predefinies, que vous pouvez notam- 
ment utiliser dans les fonctions comme parametres permettant de definir des options. 
Nous ne pouvons les citer toutes tant elles sont nombreuses, mais nous les definirons au 
fur et a mesure de nos besoins. 

Le tableau 2-3 definit quelques constantes utiles a connaitre. Si, par curiosite, vous voulez 
afficher 1' ensemble des constantes existantes, vous pouvez ecrire le code suivant : 

<?php 

print_r(get_defined_constants( ) ) ; 
?> 

Vous obtenez une liste impressionnante, dont un grand nombre des valeurs sont des entiers. 
Tableau 2-3 - Quelques constantes predefinies 



PHPJ/ERSION 


1 

Version de PHP installee sur le serveur 


PHP_0S 


Norn du systeme d'exploitation du serveur 


DEFAULT_INCLUDE_PATH 


Chemin d'acces aux fichiers par defaut 


FILE 


Nom du fichier en cours d'execution 


LINE 


Numero de la ligne en cours d'execution 



En complement, vous trouverez a la section consacree aux fonctions mathematiques, 
ulterieurement dans ce chapitre, une liste de constantes mathematiques classiques. 
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Les types de donnees 



Dans PHP, il n'existe pas de declaration explicite du type d'une variable lors de sa crea- 
tion. Meme PHP 5 reste un langage pauvrement type compare a Java ou au C. 

PHP permet la manipulation d'un certain nombre de types de donnees differents dans 
lequel on distingue : 

• Les types scalaires de base : 

- Entiers, avec le type integer, qui permet de representer les nombres entiers dans les 
bases 10, 8 et 16. 

- Flottants, avec le type doubl e ou f 1 oat, au choix, qui representent les nombres reels, 
ou plutot decimaux au sens mathematique. 

- Chaines de caracteres, avec le type string. 

- Booleens, avec le type boolean, qui contient les valeurs de verite TRUE ou FALSE (soit 
les valeurs 1 ou si on veut les afficher). 

• Les types composes : 

- Tableaux, avec le type array, qui peut contenir plusieurs valeurs. 

- Objets, avec le type object. 

• Les types speciaux : 

- Type resource. 

- Type null. 

Vous verrez dans les sections suivantes de quelle maniere vous pouvez definir des varia- 
bles pour qu'elles aient un des types ci-dessus. 

Determiner le type d'une variable 

Avant de manipuler des variables, en utilisant, par exemple, des operateurs, il peut etre 
utile de connaitre leur type. Cela permet de s' assurer que le resultat obtenu est conforme 
a ce qui est attendu et qu'il n'y a pas d'incompatibilite entre les types de ces variables. 
L'operateur d' incrementation applique a une chaine, par exemple, peut donner des resul- 
tats curieux. 

La principale fonction permettant de determiner le type d'une valeur est gettypeO, dont 
la syntaxe est la suivante : 

string gettype($mavar) 

Elle retourne une chaine de caracteres contenant le type de la variable en clair. 

Les fonctions suivantes permettent de verifier si une variable est d'un type precis : 

• is_integer($var) ou is_int($var) 

• is_doubl e($var) 

• is_string($var) 
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• is_bool($var) 

• is_array($var) 

• is_object($var) 

• is_resource($var) 

• is_nul 1 ($var) 

Elles retournent la valeur booleenne TRUE si la variable est du type recherche et FALSE dans 
le cas contraire. 

Vous pouvez savoir si une variable contient une valeur scalaire en appelant la fonction 
is_scalar($var) et, plus precisement, si elle contient une valeur numerique de type 
integer ou double en appelant la fonction is_numeric($var). 

Dans le code suivant, la variable $var est incrementee d'une unite uniquement si elle 
contient une valeur numerique (repere Q)> et l a variable $var2 est concatenee avec la 
chaine "a tous" uniquement si elle est de type string (repere @) : 

<?php 

$var = 73; 

if(is_int($var)) <^Q 

{ 

$var++; 

echo "La variable vaut $var <br />"; 

} 

// affiche: La variable vaut 74 

$var2="Bonjour "; 

if(is_string($var2)) <— Q 

{ 

$var2.=" a tous!"; 

echo $var2; 

} 

//affiche "Bonjour a tous" 

?> 

La conversion de type 

Malgre la grande souplesse, ou le grand laxisme, selon les opinions, de PHP a l'egard des 
types des variables, il peut etre indispensable de convertir explicitement une variable 
d'un type dans un autre. C'est particulierement vrai pour les variables issues d'un formu- 
laire, ce dernier etant l'outil essentiel de communication du poste client au serveur. Ces 
variables sont toujours de type string. 

Pour convertir une variable d'un type dans un autre, utilisez la syntaxe suivante : 

$result = (type_desire) $mavar; 

Si vous creez bien de la sorte une nouvelle variable du type desire a partir de la premiere 
variable, celle-ci conserve son type initial. Si vous n'avez pas de raison de craindre de 
perdre la valeur initiale, il vous suffit de donner le meme nom aux deux variables. 



PHP 5 



Dans l'exemple suivant, vous transformez une chaine de caracteres successivement en 
nombre decimal puis en entier et enfin en booleen : 

<?php 

$var="3.52 kilometres"; 

$var2 = (double) $var; 

echo "\$var2= ",$var2,"<br />" ;//affiche "$var2=3.52" 

$var3 = (integer) $var2; 

echo "\$var3= ",$var3,"<br />" ;//affiche "$var3=3" 

$var4 = (boolean) $var3; 

echo "\$var4= ",$var4,"<br />" ;//affiche "$var4=l" soit la valeur true 

?> 

Vous avez egalement la possibilite de modifier le type de la variable elle-meme au moyen 
de la fonction settype( ), dont la syntaxe est la suivante : 

boolean settype($var , "type _desire") 

Elle retourne la valeur TRUE si l'operation est realisee et FALSE dans le cas contraire. Avec 
cette fonction, le code precedent devient : 

<?php 

$var="3.52 kilometres"; 

settype($var, "double" ) ; 

echo "\$var= ",$var,"<br />" ;//affiche "$var=3.52" 

settype($var, "integer" ) ; 

echo "\$var= ",$var,"<br />" ;//affiche "$var=3" 

settype($var, "boolean") ; 

echo "\$var= ",$var,"<br />" ;//affiche "$var=l" soit la valeur true 

?> 



Controler I'etat d'une variable 

Lors de l'envoi de donnees d'un formulaire vers le serveur, le script qui recoit les infor- 
mations doit pouvoir detecter l'existence d'une reponse dans les champs du formulaire. 
Les fonctions i sset( ) et empty ( ) permettent ce type de controle. 

La fonction i sset( ), dont la syntaxe est la suivante : 

boolean isset(Svar) 

retourne la valeur FALSE si la variable $var n'est pas initialisee ou a la valeur NULL et la 
valeur TRUE si elle a une valeur quelconque. 

La fonction empty ( ), dont la syntaxe est la suivante : 

j boolean empty($var) 

retourne la valeur TRUE si la variable $var n'est pas initialisee, a la valeur ou NULL ou la 
chaine "0", et la valeur FALSE si elle a une quelconque autre valeur. 

L'exemple suivant illustre les differences subtiles entre ces deux fonctions : 
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<?php 
$a=nul 1 ; 
if (isset( 
else {ech 
if (empty ( 
else {ech 
//Affiche 
$b=0; 
if (isset( 
else {ech 
if (empty ( 
else {ech 
//Affiche 
$c=l; 
if (isset( 
else {ech 
if (empty ( 
else {ech 
//Affiche 
?> 



$a)){echo "\$a existe deja<br />";} 
o "\$a n'existe pas<br />";} 
$a)){echo "\$a est vide <br />";} 
o "\$a a la valeur $a<br />";} 
a n'existe pas" et "$a est vide" 

$b)){echo "\$b existe deja<br />";} 
o "\$b n'existe pas<br />";} 
$b)){echo "\$b est vide <br />";} 
o "\$b a la valeur $b<br />";} 
"$b existe deja" et "$b est vide" 

$c)){echo "\$c existe deja<br />";} 
o "\$c n'existe pas<br />";} 
$c)){echo "\$b est vide <br />";} 
o "\$c a la valeur $c<br />";} 

c existe deja" et "$c a la valeur 1" 



Pour la variable $a qui a la valeur NULL, i sset( ) retourne egalement FALSE et empty( ). Pour 
$b, qui a la valeur 0, issetO permet de detecter l'existence de cette variable bien que 
empty( ) la declare vide. II en irait de meme si $b etait une chaine vide. 

Pour une valeur numerique affectee a la variable $c, les deux fonctions retournent TRUE. 
Ces fonctions, et en particulier issetO, vous permettront de verifier si un utilisateur a 
bien rempli tous les champs d'un formulaire (voir le chapitre 6). 



Les entiers 



Le type integer est affecte aux variables qui contiennent des valeurs entieres positives ou 
negatives en base 10 (decimal), en base 8 (octal) ou en base 16 (hexadecimal). 

Les entiers sont codes sur 32 bits sur la plupart des plates-formes, mais cela peut varier 
en fonction des serveurs. L'intervalle de valeur des entiers est done dans ce cas de 

- 2 147 483 648, soit - 2 31 a + 2 147 483 647, soit 2 31 - 1 en base 10. 

Si une operation sur une variable de type i nteger l'amene a contenir une valeur en dehors 
de cet intervalle, elle est automatiquement convertie en type double et conserve sa 
nouvelle valeur. 

Les nombres en base 10 s'ecrivent de la maniere, que chacun connait : 



Svarint 
$varint 



1789; 
-758; 



Les nombres en base 8 doivent commencer par le chiffre 0, precede eventuellement d'un 
signe et suivi de un ou plusieurs chiffres strictement inferieurs a 8 : 

I$varoct = 03267; 
echo $varoct;//va afficher 1719 
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soit la valeur 3 X 8 3 + 2 x 8 2 + 6 x 8 1 + 7 x 8°, done 1719 en decimal. 

Notez que PHP n'affiche pas directement les valeurs en octal et que l'utilisation de 
l'instruction echo $varoct n'affiche done pas 03267 mais la valeur decimale 1719. 

Les sections suivantes donnent les differentes fonctions de conversion entre les bases 
de numeration. 

Les nombres en base 16 commencent par les caracteres Ox, ou OX, au choix, suivis de un 
ou plusieurs chiffres (de a 9) ou des lettres A (pour 10) a F (pour 15) : 



$varhex = 0xFAC7; 

echo $varhex;//Affiche 64199 



soit, en decimal, la valeur : 

15 x 16 3 + 10 x 16 2 + 12 x 16 1 + 7 x 16° = 64199. 

La encore, la deuxieme ligne de code n'affiche pas la valeur hexadecimale. Pour afficher 
la valeur hexadecimale, utilisez les fonctions de conversion mathematiques, presentees 
ulterieurement dans ce chapitre. 



Les flottants 



Le type doubl e est cense representer les nombres reels. En fait, une representation exacte 
des reels est impossible a realiser dans la plupart des cas avec un nombre de bits limites, 
ici 32 bits. 

En toute rigueur, le type double represente l'ensemble des nombres decimaux avec une 
precision de 14 chiffres, ce qui est suffisant dans la plupart des cas. Ce n'est pas un detail 
si vous voulez proceder a des calculs precis, scientifiques par exemple. 

Pour effectuer des calculs plus precis qu'avec des nombres de type double, vous pouvez 
utiliser la bibliotheque BCMath. Presente par defaut dans Wampserver et sur de 
nombreux serveurs susceptibles d'heberger votre site, elle fournit un eventail de fonc- 
tions de calcul avec une precision choisie a l'avance (pour plus de details voir la page 

http://fr2.php.net/manual/fr/book.bc.php). 

PHP admet pour les nombres flottants la notation decimale classique, avec le point 
comme separateur, et la notation exponentielle, dite scientifique, avec le symbole e ou E. 

Vous pouvez done avoir les notations suivantes : 

<?php 

$vardbl = 1952.36; 

$vardbl2= 1 . 95236E3 ; //Soi t 1.95236 x 1000 

echo $vardbl2,"<br />" ;//Affiche 1952.36 

$vardbl3= 1.95236e3; 

echo $vardbl3,"<br />" ;//Affiche 1952.36 

echo $vardbl3*100000000000,"<br />" ;//Affiche 1.95236E14 

?> 
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L'affichage se fait sous forme decimale tant que le nombre a moins de 15 chiffres. Au- 
dela, il est fait sous forme exponentielle. 



Les operateurs numeriques 

PHP offre un large eventail d'operateurs utilisables avec des nombres. Les variables ou 
les nombres sur lesquels agissent ces operateurs sont appeles les operandes. 

Le tableau 2-4 donne la description de ces operateurs, dont la plupart vous sont certaine- 
ment familiers. 



Operateur 



Tableau 2-4 - Les operateurs numeriques 

Description 

Addition 

Soustraction 

Multiplication 

Division 

Modulo : reste de la division du premier operande par le deuxieme. Fonctionne aussi avec des 
operandes decimaux. Dans ce cas, PHP ne tient compte que des parties entieres de chacun 
des operandes. 

$var = 159; 

echo $var%7; //affiche 5 car 159=22x7 + 5. 

$var = 10.5; 

echo $var£3.5; //affiche let non pas 0. 

Decrementation : soustrait une unite a la variable. II existe deux possibilit.es, la predecrementation, 

qui soustrait avant d'utiliser la variable, et la postdecrementation, qui soustrait apres avoir utilise la 

variable. 

$var=56; 

echo $vai — ; //affiche 56 puis decremente $var. 

echo $var; //affiche 55. 

echo --$var; //decremente $var puis affiche 54. 

Incrementation : ajoute une unite a la variable. II existe deux possibilites, la preincrementation, qui 

ajoute 1 avant d'utiliser la variable, et la postincrementation, qui ajoute 1 apres avoir utilise la variable. 

$var=56; 

echo $var++; //affiche 56 puis incremente $var. 

echo $var; //affiche 57. 

echo ++$var; //incremente $var puis affiche 58. 



Les fonctions mathematiques 

Le module de base de PHP offre un grand nombre de fonctions mathematiques utiles. 
Les noms des fonctions n'etant pas sensibles a la casse, vous pouvez ecrire abs( ), Abs( ) 
ou ABS( ) pour la fonction valeur absolue, par exemple. 

Le tableau 2-5 recapitule les fonctions mathematiques offertes par PHP. 
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Tableau 2-5 - 


Les fonctions mathematiques 


double/ 


'integer abs (double/integer X) 


Valeur absolue de X : 

echo abs(-543); //affiche 543. 


double 


acos (double X) 


Arc cosinus de X, qui doit etre compris entre - 1 et + 1 . Le 
resultat est en radians : 

echo acos(0.5); // affiche 1.0471975511966. 


double 


acosh (double X) 


Arc cosinus hyperbolique de X. Ne fonctionne pas sous 
Windows. 


double 


asin (double X) 


Arc sinus de X, qui doit etre compris entre - 1 et + 1 . Le resultat 

est en radians : 

echo asin(0.5); // affiche 0.5235987755983. 


double 


asinh (double X) 


Arc sinus hyperbolique de X. Ne fonctionne pas sous Windows. 


double 


atan (double X) 


Arc tangente de X. Le resultat est en radians : 

echo atan(5);// affiche 0.46364760900081. 


double 


atan2 (double Y, double X ) 


Arc tangente du rapport Y/X. Le resultat est en radians. II taut 
que Y soit different de 0. 


double 


atanh (double X) 


Arc tangente hyperbolique de X. 


string base_convert (string N, 
integer Bl, integer B2) 


Convertit le nombre N contenu dans une chaine de la base B1 
dans la base B2. 


integer bindec (string X) 


Convertit un nombre binaire X contenu dans une chaine en 
base 1 0. 


double 


ceil (double X) 


Retourne rentier immediatement superieur a X. 


double 


cos (double X) 


Cosinus de X qui doit etre exprime en radians. 


double 


cosh (double X) 


Cosinus hyperbolique de X. 


string 


decbin (integer X) 


Convertit X de la base 10 en binaire. 


string 


dechex (integer X) 


Convertit X de la base 10 en hexadecimal. 


string 


decoct (integer X) 


Convertit X de la base 10 en octal. 


double 


deg2rad (double X) 


Convertit X de degres en radians. 


double 


exp (double X) 


Exponentielle de X, soit e x . 


double 


expml (double X) 


Retourne I'exponentielle de X - 1 , soit ex -1 . 


double 


floor (double X) 


Retourne la partie entiere de X, soit rentier immediatement 
inferieur a X. 


double 


fmod (double X. double Y) 


Retourne le reste de la division de Y par X pour des operandes 
de type double. 


integer getrandmax (void) 


Indique la valeur maximale retournee par la fonction rand( ). 


integer hexdec (string CH) 


Convertit la chaine hexadecimale CH en decimal. 


double 


hypot (double X, double Y) 


Retourne la valeur de I'hypotenuse d'un triangle rectangle dont 
les cotes de Tangle droit sont X et Y, done la valeur de la racine 
carree de (X 2 + Y 2 ). 
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Tableau 2-5 - Les fonctions mathematiques (suite) 

boolean is_finite ( double X) Retourne TRUE si la valeur X est finie, c'est-a-dire dans I'inter- 

valle des valeurs admises pour un double, et FALSE dans le cas 
contraire. 

boolean is_infinite ( double X) Retourne TRUE si la valeur X est superieure a la valeur maxi- 

male admise pour un double, et FALSE dans le cas contraire. 

boolean is_nan (double X) Retourne TRUE si la valeur X n'est pas un nombre, et FALSE 

dans le cas contraire. 

double lcg_value (void) Retourne un nombre aleatoire compris entre et 1 . 

double log (double X, double B) Logarithme neperien (de base e) du nombre X. 

double loglO (double X) Logarithme decimal (de base 10) de X. 

double loglp (double X) Logarithme neperien de (1 + X). 

double/integer max (double/integer X, Retourne la valeur maximale de X et de Y. 

double/integer Y) 

double/integer min (double/integer X, Retourne la valeur minimale de X et de Y. 

double/integer Y) 

integer mt_getrandmax (void) Retourne la plus grande valeur aleatoire que peut retourner la 

fonction mt_rand(). 

integer mt_rand ( integer Min, integer Genere un resultat compris entre Min et Max ou entre et la 
Max) constante RAND_MAX si vous omettez les parametres. 

void mt_srand ( integer N) Initialise le generateur de nombres aleatoires pour la fonction 

mt_rand ( ) . Le parametre N est un entier quelconque. 

integer octdec (string CH) Convertit un nombre octal contenu dans la chaine CH en 

base 10. 

double pi (void) Retourne la valeur de pi. 

double/integer pow (double/integer X, Calcule X a la puissance Y. Les parametres peuvent etre 

double/integer Y) entiers ou decimaux. 

double rad2deg (double X) Convertit X de radians en degres. 

integer rand (integer Min, integer Max) Retourne un nombre aleatoire compris entre Min et Max y 

compris les bornes. 

double round (double X, integer N) Arrondit X avec N decimales. 

double sin (double X) Sinus de X exprime en radians. 

double sinh (double X) Sinus hyperbolique de X. 

double sqrt (double X) Racine carree de X (qui doit etre positif). 

void srand (integer N) Initialise le generateur de nombres aleatoires de la fonction 

randO. Le parametre West un entier quelconque. 

double tan (double X) Tangente de X qui doit etre en radians. 

double tanh (double X) Tangente hyperbolique de X. 
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Les booleens 



L'utilisation d'expressions booleennes est a la base de la creation des instructions condi- 
tionnelles, qui permettent de gerer le deroulement d'un algorithme. 

En plus de la definition du type boolean, il est important de connaitre la maniere dont 
PHP precede a 1'evaluation des expressions dans un contexte booleen. Certaines evalua- 
tions ne sont pas du tout intuitives et peuvent donner des resultats inattendus au premier 
abord. 



Le type boolean 



Le type boolean est surement le plus simple puisqu'il ne peut contenir que deux valeurs 
differentes TRUE ou FALSE, correspondant aux valeurs vrai et faux qui peuvent etre prises 
par une expression conditionnelle. Par exemple, $a < 75 est evaluee a TRUE si $ a vaut 74 et 
a FALSE si $ a vaut 76. 

L' exemple de code suivant : 

<?php 

$a=80; 

$b= ($a<95); 

echo "\$sb vaut ",$b,"<br />"; 

?> 

affiche $b vaut 1. 

La variable $b est de type boolean car elle est le resultat de l'expression $a<95. Sa valeur 
est TRUE. PHP assimile en interne la valeur TRUE a 1 et la valeur FALSE a 0, ce qui est un 
heritage de PHP 3, dans lequel le type boolean n'existait pas explicitement. C'est pour 
cette raison que l'affichage de $b est 1 au lieu de TRUE et une chaine vide au lieu de si $b 
vaut FALSE, ce qui peut etre deconcertant. 

Vous pouvez bien stir affecter directement des variables avec des valeurs booleennes, 
comme ci-dessous : 

|$vart = TRUE;//ou encore $vart =true 
$varf = FALSE;//ou encore $varf =false 

Cette methode n'est toutefois a utiliser que pour modifier explicitement la valeur d'une 
variable existante ou pour s'assurer de l'existence d'une valeur par defaut. 

Nous manipulons generalement non pas des variables booleennes mais des expressions 
a valeur booleenne dans des instructions conditionnelles, comme if($a<95), dans 
laquelle l'expression $a<95 a une evaluation a TRUE ou a FALSE selon la valeur de $a. 

L'expression peut etre une fonction dont la valeur de retour est un booleen. PHP realise 
une evaluation booleenne d'un certain nombre d'expressions qui ne comportent pas 
d'operateurs de comparaison. 
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Vous pouvez done ecrire : 

|$a=15; 
i f ( $ a ) {echo "$a existe et vaut $a";} 

L'expression entre parentheses qui ne contient que la variable $a est evaluee a TRUE car la 
variable $a existe et a une valeur non nulle. Dans le contexte a" evaluation booleenne de 
1' instruction if la valeur de $a n'a pas d' importance. 

Vous pouvez traduire if($a) par « si $a existe et a une valeur », ce qui est vrai dans 
l'exemple ci-dessus. Chaque expression simple ou complexe peut done etre evaluee par 
une valeur booleenne en dehors de sa valeur propre, numerique ou autre. 

Evaluation booleenne des expressions 

Le tableau 2-6 indique la maniere dont sont evaluees les expressions PHP dans un 
contexte booleen. II est important de bien connaitre ces regies. 

Tableau 2-6 - Regies devaluation booleenne des expressions 



Expressions - Le mot-cle FALSE 

evaluees a FALSE - La valeur entiere de type integer 

- La valeur decimale . de type double 

- La chaine "0" de type string 

- Une variable de type NULL 

- Une variable non initialises 

- Un tableau vide 

- Un objet sans propriete ni methode 

- Une expression logique fausse utilisant un ou plusieurs operateurs 

Expressions Toutes les autres possibilites, y compris rentier -1, car il est non nul, et la chaine "f al se" 

evaluees a TRUE car elle est non vide. Les variables de type resource sont egalement evaluees a TRUE. 



Les operateurs booleens 

Quand ils sont associes, les operateurs booleens servent a ecrire des expressions simples 
ou complexes, qui sont evaluees par une valeur booleenne TRUE ou FALSE. 

Typiquement utilises dans les instructions conditionnelles (voir le chapitre 3), ils se 
decomposent en deux categories : les operateurs de comparaison (voir tableau 2-7), qui 
testent, par exemple, l'egalite de deux valeurs, et les operateurs logiques proprement dits, 
qui servent a ecrire des expressions composees (voir tableau 2-8). 

II est important de bien manipuler ces operateurs car ils sont a la base de 1' elaboration des 
expressions conditionnelles complexes. En regie generale, les operandes de ces opera- 
teurs sont des expressions plus ou moins complexes. 
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Tableau 2-7 - Les operateurs de comparaison 



Operateur Description 

Teste I'egalite de deux valeurs. 

L'expression $a == $b vaut TRUE si la valeur de $a est egale a celle de $b et FALSE dans le cas 

contraire : 

$a = 345; 

$b = "345"; 

$c = ($a==$b); 

$c est un booleen qui vaut TRUE cardans un contexte de comparaison numerique, la chaine "345" 

est evaluee comme le nombre 345. Si $b="345 elephants" nous obtenons le meme resultat. 



< 

<= 
> 
>= 



! = ou<> 


Teste I'inegalite de deux valeurs. 




L'expression $a ! = $b vaut TRUE si la valeur de $a est differente de celle de $b et FALSE dans le 




cas contraire. 



Teste I'identite des valeurs et des types de deux expressions. 

L'expression $a === $b vaut TRUE si la valeur de $a est egale a celle de $b et que $a et $b sont 

du meme type. Elle vaut FALSE dans le cas contraire : 

$a = 345; 

$b = "345"; 

$c = ($a===$b) ; 

$c est un booleen qui vaut FALSE car si les valeurs sont egales, les types sont differents (integer 

et string). 

Teste la non-identite de deux expressions. 

L'expression $a |-» $b vaut TRUE si la valeur de $a est differente de celle de $bousi $a et $bsont 

d'un type different. Dans le cas contraire, elle vaut FALSE : 

$a = 345; 

$b = "345"; 

$c = ($a!==$b); 

$c est un booleen qui vaut TRUE car si les valeurs sont egales, les types sont differents (integer et 

string). 

Teste si le premier operande est strictement inferieur au second. 

Teste si le premier operande est inferieur ou egal au second. 

Teste si le premier operande est strictement superieur au second. 

Teste si le premier operande est superieur ou egal au second. 



Tableau 2-8 - Les operateurs logiques 



Operateur 


Description 


OR 


Teste si I'un au moins des operandes a la valeur TRUE : 




$a = true; 




$b = false; 




$c = false; 




$d = ($a OR $b);//$d vaut TRUE. 




$e = ($b OR $c); //$e vaut FALSE. 


II 


Equivaut a I'operateur OR mais n'a pas la meme priorite. 
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XOR 



AND 



Tableau 2-8 - Les operateurs logiques (suite) 

Teste si un et un seul des operandes a la valeur TRUE : 

$a = true; 

$b - true; 

$c = false; 

$d = ($a XOR $b); I Hi vaut FALSE. 

$e = ($b XOR $c); //$e vaut TRUE. 

Teste si les deux operandes valent TRUE en meme temps : 
$a - true; 



$b - 


= true; 




$c 


■ false; 




$d 


■ ($a AND $b); 


//$d vaut TRUE. 


$e 


■ ($b AND $c); 


//$e vaut FALSE. 



Equivaut a I'operateur AND mais n'a pas la meme priorite. 

Operateur unaire de negation, qui inverse la valeur de I'operande : 

$a = TRUE; 

$b = FALSE; 

$d = !$a; //$d vaut FALSE. 

$e = !$b; //$e vaut TRUE. 



Attention 

Une erreur classique dans I'ecriture des expressions conditionnelles consiste a confondre I'operateur de 
comparaison == avec I'operateur d'affectation =. 

L'usage des parentheses dans la redaction des expressions booleennes est souvent indispensable et 
toujours recommande pour eviter les problemes lies a I'ordre devaluation des operateurs. 



Les chaTnes de caracteres 

Les chaines de caracteres sont avec les nombres les types de donnees les plus manipules sur 
un site Web. De surcroit, dans les echanges entre le client et le serveur au moyen de formu- 
laires, toutes les donnees sont transmises sous forme de chaines, d'oil leur importance. 

Delink des chaines 

Une chaine de caracteres est une suite de caracteres alphanumeriques contenus entre des 
guillemets simples (apostrophes) ou doubles. Par exemple : 

|$a = ' PHP5 et MySQL'; 
$b = "PHP5 et MySQL"; 

Si les chaines ne contiennent que des caracteres, les deux types de notation sont parfaite- 
ment equivalents. Si une chaine contient une variable, celle-ci est evaluee, et sa valeur 
incorporee a la chaine uniquement si vous utilisez des guillemets et non des apostrophes : 



$a = 



PHP' 
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$b = 'MySQL'; 

$c = "PHP et $b";//affiche : PHP et MySQL 

$d = 'PHP et $b'; 

/*affiche PHP et $b car $ et b sont considered comme des caracteres sans 

^-signification particul iere*/ 

Se pose alors la question de l'inclusion des guillemets simples ou doubles comme carac- 
teres normaux a l'interieur d'une chaine. 

Pour inclure une apostrophe dans une chaine delimitee par des apostrophes, il faut les 
faire preceder du caractere d'echappement antislash \. Le principe est le meme pour 
les guillemets. 

L'exemple suivant : 

|$a = 'Faire lVouverture '; 
echo $a; 

affiche le texte « Faire l'ouverture », et le suivant : 

|$b = "Sa devise est : V'Liberte, Egalite, FraterniteV "; 
echo $b; 

affiche « Sa devise est : "Liberte, Egalite, Fraternite" ». 

Si vous voulez utiliser le caractere \ en tant que tel dans une chaine, vous devez le faire 
preceder d'un autre antislash. 

L'exemple suivant : 

|$path = "C:\\php\\www\\exemple.php"; 
echo $path; 

affiche « C:\php\www\exemple.php ». 

Le tableau 2-9 indique les sequences d'echappement utiles en PHP. 



Tableau 2-9 - Les sequences d'echappement 



Seq 


Lience 


Signification 


V 






Affiche une apostrophe. 


\" 






Affiche des guillemets. 


\$ 






Affiche le signe $. 


w 






Affiche un antislash. 


\n 






Nouvelle ligne (code ASCII OxOA). 


\r 






Retour chariot (code ASCII OxOD). 


\t 






Tabulation horizontale (code ASCII 0x09). 


\[0- 


7] 


{1,3} 


Sequence de caracteres designant un nombre octal (de 1 a 3 caracteres a 7) et 
affichant le caractere correspondant : 

echo "\115\171\123\121\114"; //Affiche MySQL. 
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Tableau 2-9 - Les sequences d'echappement (suite) 

\x[0-9 A-F a-f] {1,2} Sequence de caracteres designant un nombre hexadecimal (de 1 a 2 caracteres 

a 9 et A a F ou a a f) et affichant le caractere correspondant : 
echo "\x4D\x79\x53\x51\x4C"; //Affiche MySQL. 



Concatener des chaines 

L'operateur PHP de concatenation est le point (.), qui fusionne deux chaines litterales ou 
contenues dans des variables en une seule chaine. 

Le code suivant : 

$a = "PHP"; 

$b = "MySQL"; 

$c = "Utilisez ".$a." et ".$b. " pour construire un site dynamique"; 

echo $c; 

affiche : 

| Utilisez PHP et MySQL pour construire un site dynamique 

Lors de l'affichage avec l'instruction echo, cette concatenation peut etre simulee en sepa- 
rant chaque chaine ou variable par une virgule. 

L'exemple suivant : 

j echo "Utilisez ",$a," et ",$b, " pour construire un site dynamique"; 

affiche le meme resultat, mais aucune chaine ne contient l'ensemble du texte. 

De nombreuses fonctions permettent d'effectuer toutes sortes de manipulations sur les 
chaines de caracteres. Le chapitre 4 leur est entierement consacre. 

Les tableaux 

Les tableaux representent un type compose car ils permettent de stacker sous un meme 
nom de variable plusieurs valeurs independantes d'un des types de base que vous venez 
de voir. C'est comme un tiroir divise en compartiments. Chaque compartiment, que nous 
nommerons un element du tableau, est repere par un indice numerique (le premier ayant 
par defaut la valeur et non 1). D'ou l'expression de tableau indice. 

Chaque element peut aussi etre identifie par une etiquette, qui est une chaine de carac- 
teres ou une variable de type stri ng, nommee cle, associee a l'element du tableau. Ce type 
de tableau est appele tableau associatif. 

Les elements de ces tableaux peuvent etre de type integer, double, boolean, string ou 
meme array, ce qui permet de creer des tableaux de tableaux, c'est-a-dire des tableaux 
multidimensionnels, ce que PHP ne permet pas explicitement, contrairement a d'autres 
langages. 
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Les elements d'un tableau pourraient aussi etre des types object ou resource, qui sont 
presentes dans les sections suivantes. 

D'une maniere primaire, vous definissez la valeur d'un element de tableau indice a l'aide 
de la syntaxe a crochets [], avec un nom de variable, suivi des crochets, qui contiennent 
l'indice ou la variable de type 1 nteger : 

$tab[0] = 2004; 

$tab[l] - 31.14E7; 

$tab[2] = "PHP5"; 

$tab[35] = $tab[2]. "et MySQL"; 

$tab[] = TRUE;//voir les paragraphes suivants 

$ind = 40; 

$tab[$ind] = "Dernier element"; 

echo "Nombre d'elements = ", count($tab); 

La variable $tab est un tableau par le simple fait que son nom est suivi de crochets et d'un 
indice. II contient maintenant six elements de types varies. 

Les trois premiers elements sont affectes en utilisant des indices incrementes d'une unite. 
Pour le quatrieme element, l'indice utilise ne succede pas aux precedents. Cela implique 
que les elements d'indice 3 a 34 sont non seulement vides mais n'existent pas. En effet, 
la fonction count($tab), qui retourne le nombre d'elements du tableau qui lui est passe en 
parametre, retourne ici la valeur 6 (en realite, ces elements sont de type NULL). 

L'element suivant est affecte sans qu'aucun indice soit precise. Dans ce cas, il a automa- 
tiquement l'indice suivant celui de l'element precedemment affecte, soit ici l'indice 36. 
L'avantage de cette syntaxe est de permettre d'ajouter un nouvel element a la fin d'un 
tableau sans connaitre la valeur du premier indice disponible. 

Le dernier element est cree en lui donnant comme indice la valeur d'une variable de type 
integer qui est de 40. 

Pour lire la valeur d'un element de tableau dans un script, il suffit d'utiliser la meme 
syntaxe en precisant l'indice de la valeur desiree. 

L'exemple suivant : 

I echo "<p> Le langage prefere de l'Open source est $tab[2] <br />"; 
echo " Utilisez $tab[35] </p>"; 

affiche : 

Le langage prefere de l'Open source est PHP 
Utilisez PHP et MySQL 

La syntaxe permettant de definir les elements de tableaux associatifs est similaire, mais 
vous remplacez l'indice numerique par une chaine de caracteres quelconques ou par une 
variable ou une constante de type string. II ne faut done pas oublier d'inclure cette 
chaine dans des apostrophes ou des guillemets, faute de quoi vous vous exposez a quel- 
ques problemes dans des cas particuliers. 
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Pour bien voir le danger de ne pas utiliser de guillemets pour definir les cles, analysez le 
code suivant, dans lequel l'element de cle "lang" est defini avec la valeur "PHP et MySQL" 
puis un element dont la cle est CTE (sans guillemets) et la valeur "ASP.NET". Comme vous 
n'avez pas utilise les guillemets, CTE ne represente pas la chaine "CTE" mais la valeur d'une 
constante definie precedemment et dont la valeur est "lang". En affichant $tab2["lang"] 
vous obtenez la valeur "ASP.NET" et non "PHP ET MySQL", laquelle a ete ecrasee. De meme, 
en affichant $tab2["CTE"], vous obtenez la valeur "JAVA". 

L' utilisation d' elements de tableau associatif dans des chaines pose probleme. 

Le fait d'ecrire : 

echo "<p> Vous utilisez $tab2[ 'deux' ] <br />"; 

provoque une erreur et 1' arret du script, ce qui ne se produit pas avec un tableau indice. 
Pour pallier cet inconvenient, il faut que la variable soit contenue dans des accolades, 
comme dans l'exemple ci-dessous : 

echo "<p> Vous utilisez {$tab2[ 'deux' ]} <br />"; 

qui realise un affichage normal, ou encore concatener les chaines et la variable comme 
ci-dessous : 

echo "<p> Vous utilisez". $tab2[ 'deux' ] . " <br />"; 

Exemple 2-2. Creation de tableaux associatifs 

<?php 

$tab2["zero"] = 2003; 

$tab2['un'] = 31.14E7; 

$tab2["deux"] = "PHP"; 

//***La ligne suivante provoque une erreur si el 1 e est decommentee 

//echo "<p> Vous utilisez $tab2['deux' ] <br />"; 

1 1*** on ecrira a la place: 

echo "<p> Vous utilisez {$tab2[ 'deux' ]} <br />"; 

define( "CTE" , "1 ang" ) ;//Cree la constante CTE 

$tab2["lang"] = " PHP ET MySQL"; 

$tab2[CTE] = " ASP.NET"; 

$tab2["CTE"] = "JAVA"; 

echo "Le nombre d'elements est ", count($tab2) , "<br />"; 

echo "L'element \$tab2[\"CTE\"] vaut " ,$tab2["CTE"] , "<br / >"; 

echo "L'element \$tab2[CTE] vaut " ,$tab2[CTE] ,"<br />"; 

echo "<p> Le langage prefere de 1 _ Open source est{$tab2["lang"]} <br />"; 

?> 

Le script retourne le resultat suivant : 

Vous utilisez PHP 

Le nombre d'elements est 5 

L'element $tab2["CTE"] vaut JAVA 

L'element $tab2[CTE] vaut ASP.NET 

Le langage prefere de 1'Open source est ASP.NET 
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Remarquez que la derniere ligne ne correspond pas du tout a vos attentes, pas plus 
d'ailleurs qu'a la realite. 



Attention 

Les cles des tableaux associatifs etant sensibles a la casse, 

$tab["cle"] 
est different de 

$tab["CLE"] 
De plus, les chaines definissant les cles ne doivent pas comporter d'espaces. 



L'exemple 2-3 cree dynamiquement une liste de liens a partir des valeurs des elements 
d'un tableau associatif. Dans la pratique, les valeurs des elements du tableau devraient 
provenir d'une base de donnees pour que la page soit reellement dynamique. Les liens 
sont affiches dans un liste a puces creee avec les balises HTML <ul> et <li>, auxquelles 
est applique un style CSS defini dans l'en-tete du document. 

Exemple 2-3. Utilisation des tableaux 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Les tableaux</title> 
<style type="text/css"> 
ul {1 ist-style-image:url ( "etoile.gif") ;} 
</style> 
</head> 
<body> 
<?php 

//creation des elements du tableau 
$tab["php"] = "php.net"; 
$tab["mysql "] = "mysql.com"; 
$tab["xhtml "] = "w3.org"; 
//creation des liens 
echo"<h2> Mes liens preferes </h2>"; 

echo "<ul><li><a href=\" http://www. {$tab[ ' php ' ]}\" title=\"Le site php.net\"> 
*  PHP </a> </li>"; 

tab['mysql ']}\ 



echo "<li><a href=\" http://www. 

*  MySQL </a> </li>"; 

echo "<li><a href=\" http://www. 

*  XHTML </a> </liX/ul>"; 

?> 

</body> 

</html> 

Le script affiche le resultat illustre a la figure 2-1. 



title=\"Le site mysql .com\"> 
tab['xhtml']}\" title=\"Le site du W3C\"> 
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Figure 2-1 

Creation dynamique de liens 

Comme les chaines, les tableaux offrent de nombreuses possibility's de manipulation des 
donnees. PHP fournit en standard un grand nombre de fonctions specialisees permettant 
d'ameliorer cette gestion. Elles seront abordees en detail au chapitre 5. 



Les objets 



PHP permet 1' utilisation des classes et utilise le type object pour toute variable creee en 
tant qu' instance d'une classe. Nous reviendrons plus en detail sur les notions de classe et 
d'objet au chapitre 9. 

La version 5 de PHP offre un eventail beaucoup plus large et rigoureux que PHP 4 de 
possibilites de programmation objet. 

Le script suivant : 

<?php 

class myclass{ 

//definition de la classe (ici el 1 e est vide) 

} 

$varcl = new myclass; <— O 

echo "Le type de la variable \$varcl est : " ,gettype($varcl ) ; <— Q 

?> 

cree une classe nommee mycl ass puis une variable $varcl a l'aide de l'operateur particu- 
lier new (repere Q). 

La ligne suivante (repere ©) afflche : 



Le type de la variable $varcl est : object 



Vous venez de creer une variable d'un type nouveau. 
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Les types divers 



PHP offre egalement deux types particuliers qui sont utilises dans des circonstances bien 
definies. 



Le type resource 



Le type resource represente une reference a des informations presentes sur le serveur. II 
est le type retourne par certaines fonctions particulieres. C'est le cas, entre autres, des 
fonctions utilisees pour acceder a une base de donnees lors de la connexion, qui retour- 
nent une valeur de type resource. Cette derniere permet d' identifier chaque connexion 
initiee par un utilisateur puis est utilisee pour retourner les donnees apres interrogation 
de la base par 1' utilisateur concerne. Cet identifiant trouve toute son utilite quand il y a 
plusieurs connexions simultanees sur une meme base, notamment a partir d'un meme 
script. 

L'exemple suivant realise une connexion au serveur MySQL a l'aide de la fonction 
mysql_connect( ) et recupere un identifiant de connexion $connect, qui est la valeur retour- 
nee par cette fonction. II affiche ensuite la valeur puis le type de cette variable. 

<?php 

/ /**************[_£ type pesource*************** 

$connect = mysql_connect( "local host" , "root" , "") or die ("ERREUR de CONNEXION"); 

echo "L' identifiant de connexion vaut : $connect <br />"; 

echo "Le type de la variable \$connect est " ,gettype($connect) ; 

?> 

Le script affiche le resultat suivant : 

L'identificateur de connexion vaut : Resource id #1 
Le type de la variable Sconnect est resource 

La lecture de la valeur de la variable $connect n'a pas d'interet particulier une fois la 
connexion realisee, mais sa recuperation permet d' acceder a la base de donnees. Pour 
plus de details, voir le chapitre 15, consacre a l'acces aux bases de donnees MySQL. 



Le type NULL 



Le type NULL, ou null, est celui qui est attribue a une variable qui n'a pas de contenu ou 
qui a ete explicitement initialisee avec la valeur NULL. Aussitot qu'une valeur legale est 
donnee a la variable, elle prend le type correspondant. 



Attention : NULL et zero 

Une variable contenant une chaine vide ou la valeur "0" n'a pas le type NULL mais stri ng. De meme, une 
variable contenant la valeur est du type 1 nteger. 
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Dans le code suivant, le code de creation de la variable $varvide (repere Q) est deconseille 
dans un script, car il genere un avertissement. De meme, l'utilisation de cette variable par 
l'instruction echo est a proscrire. 

<?php 

//***************"| e type NULL**************************** 

$varvide; <— © 

echo "La variable vide vaut : Svarvide <br />"; 

echo "Le type de la variable \$varvide est " ,gettype($varvide) , " <br />"; 

$varvide="" ; 

echo "La variable vide vaut : Svarvide <br />"; 

echo "Le type de la variable \$varvide est " ,gettype($varvide) ; 

?> 

Le code affiche le resultat suivant : 

La variable vide vaut : 

Le type de la variable $varvide est NULL 

La variable vide vaut : 

Le type de la variable Svarvide est string 



Memo des fonctions 



boolean definetstring nom_cte, valeur [,bool casse]) 

Cree la constante nom_cte et lui attribue une valeur. Le parametre casse indique que le nom de la constante est insen- 
sible a la casse (TRUE) ou non. 

boolean definedtstring nom_cte) 

Retourne TRUE si la constante nom_cte existe et FALSE dans le cas contraire. 

string gettype($nom_var) 

Retourne le type de la variable $nom_var. 

boolean empty($nom_var) 

Retourne TRUE si la variable $nom_var n'est pas affectee ou a une des valeurs NULL, ou "0" et FALSE dans le cas 
contraire. 

boolean isset($nom_var) 

Retourne TRUE si la variable $nom_var existe et est definie avec une valeur differente de NULL. 

array get_defined_constants( ) 

Retourne un tableau contenant toutes les constantes predefines et celles qui ont ete creees dans le script. 

boolean settype($var , string type) 

Effectue le transtypage de $var dans le type precise. Retourne TRUE si I'operation est reussie et FALSE dans le cas 
contraire. 
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boolean is_array($var) 

boolean is_bool ($var) 

boolean is_doubl e($var) 

boolean is_integer($var) 

boolean is_nul 1 ($var) 

boolean is_object($var) 

boolean is_resource($var) 

boolean is_string($var) 

Ces fonctions retournent TRUE si la variable est du type teste et FALSE dans le cas contraire. 



Exercices 



Exercice 1 

Parmi les variables suivantes, lesquelles ont un nom valide : mavar, $mavar, $var5, $_ 
mavar, $_5var, $ elementl, $hotel4* ? 

Exercice 2 

Donnez les valeurs de $x, $y, $z a la fin du script suivant : 

$x="PostgreSQL"; 
$y="MySQL"; 
$z=&$x; 
$x="PHP 5"; 
$y=&$x; 

Exercice 3 

Lisez les valeurs des variables du script de l'exercice 2 a l'aide du tableau SGLOBALS. 

Exercice 4 

Determinez le numero de version de PHP, le nom du systeme d' exploitation de votre 
serveur ainsi que la langue du navigateur du poste client. 

Exercice 5 

Donnez la valeur de chacune des variables pendant et a la fin du script suivant, et verifiez 
revolution du type de ces variables : 

$x="PHP5"; 

$a[]=&$x; 

$y=" 5 eme version de PHP"; 

$z=$y*10; 

$x.=$y; 

$y*=$z; 

$a[0]="MySQL"; 
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Exercice 6 

Donnez la valeur des variables $x, $y, $z a la fin du script : 

$x="7 personnes"; 
$y=(integer) $x; 
$x="9E3"; 
$z=(double) $x; 

Exercice 7 

Donnez la valeur booleenne des variables $a,$b,$c,$d,$eet$f: 

$a="0"; 
$b="TRUE"; 
$C=FALSE; 
$d=($a OR $b); 
$e=($a AND $c); 
$f=($a XOR $b); 
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Les instructions de controle 



On retrouve dans PHP la plupart des instructions de controle des scripts. Indispensables 
a la gestion du deroulement d'un algorithme quelconque, ces instructions sont presentes 
dans tous les langages. PHP utilise une syntaxe tres proche de celle du langage C. 

Ceux qui ont deja pratique un langage tel que le C ou plus simplement JavaScript seront 
en pays de connaissance. Pour les autres, une adaptation sera sans doute necessaire. La 
version 5 de PHP a vu 1' apparition de nouvelles instructions dediees a la gestion des 
exceptions, comme try...catch ou throw, qui lui faisaient defaut jusqu' a present. 



Les instructions conditionnelles 

Comme tout langage, PHP dispose d' instructions conditionnelles qui permettent d'orien- 
ter le deroulement d'un script en fonction de la valeur de donnees. 

Uinstruction if 

L'instruction if est la plus simple et la plus utilisee des instructions conditionnelles. 
Presente dans tous les langages de programmation, elle est essentielle en ce qu'elle permet 
d'orienter l'execution du script en fonction de la valeur booleenne d'une expression. 

Sa syntaxe est la suivante : 

if (expression) instruction; 

Si l'expression incluse dans les parentheses est evaluee a la valeur booleenne TRUE, 
l'instruction qui suit est executee. Dans le cas contraire, l'execution passe directement a 
la ligne suivante. 
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L'instruction if peut etre suivie d'un bloc d' instructions delimite par des parentheses qui 
sera entierement execute dans les memes conditions : 

if (expression) 

{ 

//bloc de code 

} 

La redaction de l'expression est importante. Elle peut devenir complexe lorsqu'elle 
comprend des operateurs logiques associant ses differents composants. 

Dans le code suivant : 

<?php 

$a=6; 

if(is_integer($a) && ($a<10 && $a>5) && ($aS 

?> 



=0) ) {echo "Conditions satisfaites" ; 



l'expression composee : 

(is_integer($a) && ($a<10 && $a>5) && ($a^2==0)) 

est evaluee a TRUE si $a repond simultanement aux trois conditions suivantes : etre un 
entier, etre compris entre 5 et 10 et etre divisible par 2, soit pour $a les valeurs possibles 
de 6 et 8 uniquement. Le message ne s'affiche done que dans ces cas. 

PHP realise une evaluation booleenne d'un grand nombre d'expressions qui ne contien- 
nent pas en elles-memes de variables booleennes. II admet, par exemple, des expressions 
du genre : 

|$a = 25; 
i f ( $ a ) {echo "La condition est vraie <br />";} 

Dans ce cas, ce n'est pas la valeur de la variable $a qui est prise en compte mais son 
evaluation booleenne, qui vaut TRUE. Nous avons deja aborde ce point au chapitre 2. Le 
lecteur pourra se reporter au tableau 2-6 pour revoir les conditions d'evaluation dans les 
differents cas. 



Ne pas se tromper d'operateur 

Une erreur courante consiste a confondre I'operateur de comparaison == avec I'operateur d'affectation 
Dans les expressions conditionnelles, pour tester I'egalite de deux valeurs il faut employer I'operateur = 
ou encore === pour tester I'identite (meme valeur et meme type). 



L'instruction if.. .else 

L'instruction if ... el se permet de traiter le cas ou l'expression conditionnelle est vraie et 
en meme temps d'ecrire un traitement de rechange quand elle est evaluee a FALSE, ce que 
ne permet pas une instruction if seule. L'instruction ou le bloc qui suit else est alors le 
seul a etre execute. L'execution continue ensuite normalement apres le bloc el se. 
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L'exemple 3-1 suivant calcule le prix net apres une remise variable en fonction du 
montant des achats selon les criteres suivants : 

• Si le prix total est superieur a 100 euros, la remise est de 10 %. Cette condition est 
traitee par l'instruction 1 f (repere Q ). 

• Pour les montants inferieurs ou egaux a 100 euros, la remise est de 5 %. Cette condi- 
tion est traitee par l'instruction el se (repere ©). 

Exemple 3-1. L'instruction if. ..else 

<?php 
$prix=55; 

if($prix>100) <-Q 
{ 

echo "<b>Pour un montant d'achat de $prix €, la remise est de 10 % </b> 

*-<br />"; 

echo "Le prix net est de " ,$prix*0.90; 
} 

else <^Q 
{ 

echo "<b>Pour un montant d'achat de $prix €, la remise est de 5 %</b><br />"; 

echo "<h3>Le prix net est de " ,$prix*0.95, "</h3>" ; 
} 
?> 

Compte tenu de la valeur attribuee ici a la variable $a, le script affiche le resultat suivant : 

Pour un montant d'achat de 55 n, la remise est de 5 % 
Le prix net est de 52.25 n 

Le bloc qui suit les instructions if ou else peut contenir toutes sortes d' instructions, y 
compris d'autres instructions if... else. Nous ob tenons dans ce cas une syntaxe plus 
complexe, de la forme : 

if (expressionl) 

{//Bloc 1} 

elseif (expression2) 

{//Bloc 2} 

else 

{//Bloc 3} 

Cette construction s'interprete de la facon suivante : si l'expression 1 est evaluee a TRUE, 
le bloc 1 est execute ; dans le cas contraire, si l'expression 2 qui suit l'instruction el sei f 
est evaluee a TRUE, le bloc 2 est execute. Dans les autres cas, c'est le bloc 3 qui est 
execute. Quelle que soit la situation, un seul bloc est execute. 

Dans l'exemple 3-11, vous voulez afficher le montant d'une remise calculee selon les 
modalites suivantes : 

• Si vous achetez un PC de plus de 1 000 euros, la remise est de 15 %. 
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• Pour un PC de 1 000 euros et moins, la remise est de 10 %. 

• Pour les livres, la remise est de 5 %. 

• Pour tous les autres articles, la remise est de 2 %. 

La premiere instruction 1f_.else1f_.else (reperes O et ©) control e la categorie du 
produit. La deuxieme instruction i f...el se determine le montant de la remise si le produit 
est un PC (reperes © et ©). L'indentation du code permet une lecture plus facile. Faute 
d'une telle indentation, il est difficile de distinguer a quelle instruction i f se rapporte une 
instruction else. 

Exemple 3-2. Les instructions if imbriquees 



<?php 
// 



******************** 



************** ** 



if. . .el seif . . .else 
$cat="PC"; 
$prix=900; 

if($cat=="PC") <-Q 
{ 
if($prix >= 1000) <-© 
{ 

echo "<b>Pour 1 'achat d'un PC d'un montant de $prix €, la remise est de 
*15 %</bXbr />"; 

echo "<h3> Le prix net est de : " ,$prix*0.85, "€ </h3>"; 
} 

else <— 
{ 
echo "<b>Pour 1 'achat d'un PC d'un montant de $prix €, la remise est de 
*10 8</bXbr />"; 
echo "<h3> Le prix net est de : " ,$prix*0.90, "€ </h3>"; 



elseif($cat=="Livres") <—Q 



echo "<b>Pour 1 'achat de livres la remise est de 5 %</ bXbr />" 
echo "<h3> Le prix net est de : " ,$prix*0.95, "€ </h3>"; 



else ^© 



echo"<b>Pour les autres achats la remise est de 2 %</ bXbr />"; 
echo "<h3> Le prix net est de : " ,$prix*0.98, "€ </h3>"; 



} 

?> 



Le resultat de ce script pour $cat a la valeur " PC" et la variable $pri x a la valeur 900 donne 
raffichage suivant : 



Pour 1 'achat d'un PC d'un montant de 900 n, la remise est de 10 % 
Le prix net est de : 810n 
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Loperateur ? 



L'operateur ? permet de remplacer avantageusement une instruction if... else en 
evaluant une expression et en attribuant a une variable une premiere valeur si la condition 
est vraie ou une autre valeur si elle est fausse. 

Sa syntaxe est la suivante : 

$var = expression ? valeurl : valeur2 
Elle est equivalente a : 

Iif(expression) {$var=valeurl;} 
else {$var=valeur2;} 

Le premier exemple de calcul de remise pourrait s'ecrire : 

|$var = ($prix>100)? "la remise est de 10 ST: "la remise est de 5 %" ; 
echo "<b>Pour un montant d'achat de $prix €: $var </b><br />"; 

au lieu de : 

if($prix>100) 
{ 
echo "<b>Pour un montant d'achat de $prix €, la remise est de 10 %</b><br />"; 



echo "<b>Pour un montant d'achat de $prix €, la remise est de 5 K/bXbr />"; 



Cet operateur est generalement employe avec des expressions booleennes courtes. 
L'exemple 3-3 adapte un texte en fonction de la valeur d'une variable, soit pour une 
formule de politesse en fonction du sexe du visiteur, soit pour mettre au pluriel un mot en 
fonction d'un nombre. 

Exemple 3-3. L'operateur ? 

<?php 

$ch = "Bonjour "; 

$sexe="M"; 

$ch .= ($sexe=="F" )?"Madame" : "Monsieur" ; 

echo "<h2>$ch</h2>"; 

$nb = 3; 

$pmu ="11 faut trouver ".$nb; 

$mot - ($nb==l)?" cheval":" chevaux"; 

echo "<h3> $pmu $mot </h3>"; 

?> 

Compte tenu des valeur des variables $sexe et $nb le resultat retourne est le suivant : 



Bonjour Monsieur 

II faut trouver 3 chevaux 



PHP 5 



Linstruction switch. ..case 

Supposez que vous vouliez associer un code de departement avec son nom reel. Avec une 
suite d' instructions if, vous ecririez le script suivant : 

<?php 

$dept=75; 

if ($dept==75) echo "Paris"; 

if ($dept==78) echo "Hauts de Seine"; 

if($dept==91) echo "Yvelines"; 

if ($dept==93) echo "Seine Saint Denis"; 

?> 

dans lequel la variable $dept proviendrait d'un formulaire, par exemple. 

Ce code peut etre simplifie sans multiplier les instructions if grace a 1' instruction 
switch. . .case. Cette derniere permet de comparer la valeur d'une expression avec une 
liste de valeurs predeterminees par le programmeur et d'orienter le script en fonction de 
la valeur de cette expression. 

La syntaxe de cette instruction est la suivante : 

switch(expression) 

{ 

case valeurl: 

//bloc d'instructions 1; 

break; 

case valeur2: 
//bloc d'instructions 2; 
break; 



case valeurN: 
//bloc d'instructions N; 
break; 

default: 

//bloc d'instructions par defaut; 

break; 
} 

Si l'expression qui suit le mot-cle switch vaut valeurl, les instructions qui suivent la 
premiere instruction case sont executees, apres quoi l'execution passe a la fin du bloc 
swi tch. II en va de meme pour les valeurs suivantes. Si aucune concordance n'est trouvee, 
ce sont les instructions qui suivent l'instruction default qui sont executees. 

La presence de cette instruction n'est pas obligatoire, mais elle est conseillee pour faire 
face a toutes les eventualites, telles les erreurs de saisie, par exemple. Chaque groupe 
case doit se terminer par une instruction break, faute de quoi les autres blocs case sont 
aussi executes. 

La valeur qui suit chaque instruction case peut etre une constante litterale ou une 
constante nommee, declaree precedemment a switch a l'aide du mot-cle define. 
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Plusieurs instructions case differentes peuvent se succeder avant qu'intervienne un bloc 
d' instructions (voir repere Q dans l'exemple 3-4). Dans ce cas, les differentes valeurs 
indiquees declenchent l'execution du meme code (repere @). 

Le script precedent devient celui de l'exemple 3-4. 



Exemple 3-4. L' instruction switch... case 

<?php 
$dept=75; 

switch($dept) 



//Premier cas 

case 75: <— © 

case "Capitale" : <— O 

echo "Paris" ; <— © 

break; 

//Deuxieme cas 

case 78: 

echo "Hauts de Seine"; 

break; 

//Troisieme cas 

case 93: 

case "Stade de f ranee": 

echo "Seine Saint Denis"; 

break; 

//la suite des departements. . . 

//Cas par defaut 

default: 

echo "Departement inconnu en He de France" 

break; 

} 

?> 



Les instructions de boucle 

Les boucles permettent de repeter des operations elementaires un grand nombre de 
fois sans avoir a reecrire le meme code. Selon l'instruction de boucle utilisee, le 
nombre d'iterations peut etre defini a l'avance ou etre determine par une condition 
particuliere. 



La boucle for 



Presente dans de nombreux langages, la boucle for permet d'executer plusieurs fois la 
meme instruction ou le meme bloc sans avoir a reecrire les memes instructions. Sa 
syntaxe est la suivante : 
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for(expressionl; expression2; expression3) 

{ 

//instruction ou bloc; 

} 

expressionl est toujours evaluee. II s'agit generalement de 1'initialisation d'une ou 
plusieurs variables servant de compteur pour la boucle. expression2 est ensuite evaluee 
avec une valeur booleenne : si elle vaut TRUE, la boucle continue et les instructions 
comprises dans le bloc sont executees, sinon la boucle s'arrete. Si elle est toujours vraie 
on obtient une boucle infinie, verifiez done qu'elle peut etre fausse. expression3 n'est 
executee qu'a la tin de chaque iteration. II s'agit le plus souvent d'une instruction 
d' incrementation de la variable compteur. 

L'exemple 3-5 cree un document qui affiche six niveaux de titre utilisant les balises <hl> 
a <h6> en deux lignes de code seulement. 

Exemple 3-5. Une boucle for simple 

<?php 

for($i=l;$i<7;$i++) 

{ 

echo "<h$i> $i :Titre de niveau $i </h$i>"; 

} 

?> 

Le resultat de la boucle est illustre a la figure 3-1. 
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Figure 3-1 

Creation de titres 



Les trois expressions utilisees dans la boucle for peuvent contenir plusieurs parties sepa- 
rees par des virgules. La boucle peut en ce cas etre realisee sur plusieurs variables, 
comme illustre a l'exemple 3-6. 
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Exemple 3-6. Une boucle a plusieurs variables 

<?php 

for($i=l,$j=9;$i<10,$j>0;$i++,$j — ) 

//$i varie de 1 a 9 et $j de 9 a 1 

{ 

echo "<span style=\"border-style:double;border-width:3;\"> $i + $j=10</span>" 

} 

?> 

Le resultat de cette boucle double est la table d' addition de la figure 3-2. 
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Figure 3-2 

Tflfo/e d' addition creee par une boucle double. 



Les boucles imbriquees 

II est possible d'imbriquer des boucles for les unes dans les autres sur autant de niveaux 
que desire, le bloc qui suit la premiere contenant toutes les autres. Chaque variable comp- 
teur declaree dans une boucle n'est utilisable que dans la boucle qui la declare et dans 
celles de niveau inferieur. 

L'exemple 3-7 ci-apres cree une table de multiplication dans un tableau XHTML a deux 
dimensions, chaque dimension etant geree par une variable compteur differente, $i et $j. 
La premiere boucle for (repere Q) ne sert qu'a creer la ligne d'en-tete de la table. La 
variable $i est locale a la boucle. Le fait de reutiliser le meme nom de variable dans 
la boucle suivante n'a done aucune importance. 

Deux autres boucles imbriquees sont ensuite utilisees pour creer le corps de la table. La 
premiere (repere©) itere les numeros de ligne avec la variable $i, et la deuxieme 
(repere ©) le contenu des cellules du tableau avec la variable $ j . 

Exemple 3-7. Les boucles for imbriquees 

|<?php 
echo "<h2> Revisez votre table de multiplicationK/ h2>"; 
//Debut du tableau HTML 
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echo "<table border=\"2\" style=\"background-color:yel low\"> <th> 

* X  </th>"; 

//Creation de la premiere ligne 

for($i=l;$i<10;$i++) 

{ 

echo "<th> $i </th>"; <— Q 

} 

//Fin de la boucle 1 

//••it************************** 

//Creation du corps de la table 
//•••it************************* 

//Boucles de creation du contenu de la table 

for($i=l;$i<10;$i++) <-© 

{ 

//Creation de la premiere colonne 

echo "<tr><th> $i </th>"; 

//Rempl issage de la table 

for($j=l;$j<10;$j++) ^© 

{ 
echo "<td style=\"background-color: red;color:white\">    <b>". $i*$j. 
*"   </td>"; 

} 

echo "</b></tr>"; 
} 

echo "</table>" 
?> 

La figure 3-3 presente la table de multiplication creee par ce script. 
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Figure 3-3 

/Vofre taWe de multiplication 



Vous trouverez de nombreux exemples d' utilisation de boucles for tout au long de 
cet ouvrage, notamment au chapitre 5 pour la lecture de l'ensemble des elements d'un 
tableau. 
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La boucle while 



La boucle for oblige a preciser les valeurs limites pour lesquelles la boucle va s'arreter. 
A moins d'utiliser une instruction if pour la stopper a l'aide de l'instruction break (voir 
le paragraphe « Sortie anticipee des boucles » dans les sections suivantes), il faut connaitre 
ces valeurs limites. La boucle while permet d'affiner ce comportement en realisant une 
action de maniere repetitive tant qu'une condition est verifiee ou qu'une expression quel- 
conque est evaluee a TRUE et done de l'arreter quand elle n'est plus verifiee (evaluee a 
FALSE). 

La boucle whi 1 e permet, par exemple, d'afficher tous les resultats fournis apres interroga- 
tion d'une base de donnees, sans en connaitre a l'avance le nombre exact. La syntaxe de 
cette instruction est la suivante : 

while(expression) 

{ 

//Bloc d'instructions a repeter; 

} 

L'expression precisee doit pouvoir etre evaluee de facon booleenne par PHP et pouvoir 
changer de valeur au cours du script, faute de quoi la boucle serait infinie. 

L'exemple suivant : 

|$a = "oui"; 
while ($a) {echo $a; } 

constitue une boucle infinie, car $a est evaluee a TRUE en tant que chaine non vide. 

De meme, dans le code suivant : 

|$a = 54; 
while ($a>100) {echo $a; } 

l'instruction echo $a n'est jamais executee car l'expression $a>100 contenue dans while 
est toujours fausse. 

L'exemple 3-8 ci-dessous effectue une suite de tirages de nombres aleatoires compris 
entre 1 et 100 grace a la fonction rand()(repere @), avec comme condition supplemen- 
taire que le nombre tire soit un multiple de 7 (repere Q). Le script affiche les nombres 
tires jusqu'a trouver un multiple de 7. 

Exemple 3-8. Tirage d'un multiple de 7 avec une boucle while 

<?php 

$n=l; 

while($n%7!=0 ) <-Q 

{ 

$n = rand(l, 100); <-© 

echo $n,"  /" ; 

} 

?> 
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Vous obtenez, par exemple, la suite de nombres 72 / 79 / 50 / 95 / 1 1 / 43 / 18 / 49 / (cette 
suite varie evidemment a chaque tirage). 

La boucle do. ..while 

La boucle do. . .while apporte une precision a la boucle while. Dans celle-ci, en effet, si 
l'expression booleenne est evaluee a FALSE, les instructions qu'elle contient ne sont 
jamais executees. Avec l'instruction do. . .while, au contraire, la condition n'est evaluee 
qu'apres une premiere execution des instructions du bloc compris entre do et whi 1 e. 

La syntaxe de la boucle do...whi 1 e est la suivante : 

do { 

//bloc d' instructions 

} 

while(expression) ; 

Le script de l'exemple 3-9 reprend celui de l'exemple 3-8, mais il n'est plus besoin cette 
fois d'initialiser la variable $i a 1 car la divisibilite par 7 n'est testee qu'apres le premier 
tirage (repere O)- 

Exemple 3-9. Tirage avec une boucle do. ..while 

<?php 

do 

{ 

$n = rand(l.lOO); 

echo $n,"  / "; 

} 

while($n%7!=0); <-© 

?> 

Les resultats obtenus sont similaires. 



La boucle foreach 



Introduite a partir de la version 4.0 de PHP, l'instruction foreach permet de parcourir 
rapidement l'ensemble des elements d'un tableau, ce que fait aussi une boucle for, mais 
foreach se revele beaucoup plus efficace. 

La boucle foreach est particulierement efficace pour lister les tableaux associatifs dont il 
n'est necessaire de connaitre ni le nombre d'elements ni les cles. Sa syntaxe est variable 
selon que vous souhaitez recuperer seulement les valeurs ou les valeurs et les cles (ou les 
indices). 

Pour lire les valeurs seules, la premiere syntaxe est la suivante : 

foreach($tableau as $valeur) 

{ 

//bloc utilisant la valeur de 1 'element courant 
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La variable Ivaleur contient successivement chacune des valeurs du tableau. II importe 
cependant de ne pas utiliser un nom de variable existant, faute de quoi sa valeur est ecrasee. 
Les variables utilisees dans une boucle foreach ne sont pas locales a la boucle et gardent 
done la valeur du dernier element lu dans tout le script. 

Pour lire les valeurs et les cles (ou les indices), la deuxieme syntaxe est la suivante : 

foreach($tableau as $cle=>$valeur) 

{ 

//bloc utilisant la valeur et la cle de 1 'element courant 

} 

Ici, la variable $cl e contient successivement l'indice ou la cle de chacun des elements du 
tableau dans l'ordre numerique pour les tableaux indices et dans l'ordre de creation des 
elements pour les tableaux associatifs. La variable $val eur contient la valeur associee a la 
cle ou a l'indice courant. 

Dans ces deux cas, la variable $tableau peut etre remplacee par une expression dont la 
valeur est du type array, comme ce pourrait etre le cas, par exemple, d'une fonction 
retournant un tableau. Cette instruction est abondamment utilisee pour lire tous les resul- 
tats obtenus apres interrogation d'une base de donnees. 

L'exemple 3-10 cree d'abord un tableau indice contenant les puissances de 2 a l'aide 
d'une simple boucle for (repere O) P u i s lit l'integralite des elements a l'aide d'une 
boucle foreach (repere ©). 

Exemple 3-10. Lecture des valeurs d'un tableau indice 

<?php 

//Creation du tableau de 9 elements 

for($i=0;$i<=8;$i++) 

{ 

$tab[$i] = pow(2,$i); <^© 
} 

$val = "Une val eur" ; 
echo Sval ,"<br />"; 
//Lecture des valeurs du tableau 
echo"Les puissances de 2 sont :"; 
foreach($tab as $val)<— © 
{echo $val . " : ";} 
?> 

Le resultat suivant est affiche : 

Les puissances de 2 sont :1 : 2 : 4 i 8 : 16 : 32 : 64 : 128 : 256: 

L'exemple 3-11 lit les indices et les valeurs du meme tableau en utilisant la deuxieme 
syntaxe (de la forme $tab as $ind=>$val ) pour recuperer les indices dans la variable $ i n d 
et les valeurs dans Sval (repere Q). II est possible de verifier que les variables $ind et $val 
sont toujours visibles a l'exterieur de la boucle en affichant leurs valeurs apres la fin de la 
boucle foreach (repere ©). 
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Exemple 3-1 1 . Lecture des indices et des valeurs 

<?php 

//Creation du tableau 

for($i=0;$i<=8;$i++) 



{ 



$tab[$i] = pow(2,$i); 
} 

//Lecture des indices et des valeurs 
foreach($tab as $ind=>$val ) <— O 
{echo " 2 puissance $ind vaut $val <br />";} 
echo "Dernier indice ",$ind, " .derniere valeur ",$val;<— Q 
?> 

L' exemple affiche la liste suivante : 



2 puissance vaut 1 
2 puissance 1 vaut 2 

2 puissance 7 vaut 128 
2 puissance 8 vaut 256 
Dernier indice 8 .derniere valeur 256 



L'exemple 3-12 cree un tableau associatif dont les cles sont des identifiants de clients et 
associe a chacun un code aleatoire compris entre 100 et 1 000 (repere Q) puis lit et affiche 
les cles et les valeurs du tableau (repere ©). 

Exemple 3-12. Lecture des cles et des valeurs 

<?php 

//Creation d'un tableau associatif 

for($i=0;$i<=8;$i++) 

{ 

$tabass["client".$i] = rand(100,1000) ; <^© 
} 

//Lecture des cles et des valeurs 
foreach($tabass as $cle=>$val ) <— Q 

{echo " Le client de login <b>$cle</b> a le code <b>$val</b><br />";} 
?> 

Les resultats suivants sont affiches : 



Le client de login clientO a le code 638 

Le client de login clientl a le code 569 

Le client de login client6 a le code 135 

Le client de login client7 a le code 786 

Le client de login client8 a le code 406 
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foreach et les objets 

Depuis PHP 5, vous pouvez lire I'ensemble des noms et des valeurs des proprietes d'un objet a I'aide 
d'une boucle foreach comme nous le faisons pour un tableau. Vous rencontrerez aux chapitres 9, 16 et 
17 des illustrations de ce type de lecture. 



Sortie anticipee des boucles 

Vous pouvez avoir besoin d'arreter une boucle avant son terme normal. Pour cela, vous 
disposez des instructions break et continue, qui permettent de realiser un arret partiel ou 
total. 

L'instruction break 

II est possible d'arreter completement une boucle for, foreach ou while avant son terme 
normal si une condition particuliere est verifiee, a I'aide de l'instruction break. Le script 
n'est pas arrete, comme avec l'instruction exit, et seule la boucle en cours se termine. 

Si plusieurs boucles sont imbriquees, seule celle qui contient l'instruction break se 
termine. Pour arreter plusieurs boucles en meme temps, on emploie la syntaxe suivante : 

break n; 

dans laquelle n designe le nombre de boucles les plus internes que vous souhaitez fermer. 
Celles de niveau superieur a n continuent a s'executer normalement. 

L'exemple 3-13 cree un tableau de noms (repere ©;. puis une boucle for lit le tableau 
(repere ©). Cette boucle contient une instruction i f qui verifie que le nom commence 
par la lettre A (repere ©). Si la condition est remplie, le script affiche le nom. La boucle 
est fermee grace a une instruction break (repere ©). 



La notation Stab[$i][0] 

La notation $tab[$i][0] permet de recuperer la premiere lettre de la chaine de caracteres contenue 
dans la variable $tab[$i],$tab[$i][l]la deuxieme lettre, et ainsi de suite. 



La fonction count($tab) 

La fonction count (Stab) retourne le nombre d'elements du tableau Stab, ce qui permet de connaitre le 
nombre maximal d'iteration de la boucle. Cette expression pourrait etre supprimee car c'est l'instruction 
break qui met fin a la boucle. II est toutefois preferable de I'utiliser pour arreter la boucle, car si le tableau 
ne contient aucun nom commengant par la lettre A, vous avez une boucle infinie, ce que le serveur 
n'appreciera pas. 
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Exemple 3-13. L'instruction break 

<?php 

//Creation d'un tableau de noms <— O 
$tab[l]="Basile"; 
$tab[2]="Conan"; 
$tab[3]="Albert"; 
$tab[4]="Vincent"; 
//Boucle de lecture du tableau 
for ($i=l;$i<count($tab );$i++) <-© 
{ 
if ($tab[$i][0]=="A") <—Q 



echo "Le premier nom commencant par A est le n' $i: ",$tab[$i]; 
break; <— O 



) 



?> 



L'instruction continue 

A la difference de l'instruction break, l'instruction continue n'arrete pas la boucle en 
cours mais seulement l'iteration en cours. La variable compteur est incrementee immedia- 
tement, et toutes les instructions qui suivent le mot-cle continue ne sont pas executees lors 
de l'iteration en cours. 

L'exemple 3-14 donne deux illustrations de ce mecanisme : 

• La premiere utilise une boucle for pour afficher tous les nombres de 1 a 20, a 1' excep- 
tion des multiples de 5 grace au code if ( $i %5==0) { continue;} (repere ©)• 

• La deuxieme utilise une boucle foreach qui parcourt un tableau de departements et 
permet de n'afficher que ceux qui commencent par la lettre E (repere ©). 



Exemple 3-14. Interruption partielle d'une boucle 

<?php 

//Interruption d'une boucle for 

for($i=0;$i<20;$i++) 

{ 

if($i%5==0) { continue;} <— © 

echo $i ,"<br />"; 

} 
//******************** 

//Interruption d'une boucle foreach 

$tab[l]="Ain"; 

$tab[2]="Allier"; 

$tab[27]="Eure"; 

$tab[28]="Eure et Loir"; 

$tab[29]="Finistere"; 

$tab[33]="Gironde"; 

foreach($tab as $cle=>$valeur) 
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if($tab[$cle][0]! = "E") { continue;}*-© 

echo "code $cle : departement " ,$tab[$cle] , "<br />"; 



) 
?> 



Le resultat affiche par cet exemple est le suivant : 



1 : 2 : 3 : 4 : 6 : 7 : 8 : 9 : 11 

code 27 : departement Eure 

code 28 : departement Eure et Loir 



12 : 13 



14 



16 : 17 : 18 : 19 : 



De meme que pour l'instruction break, si plusieurs boucles sont imbriquees, il est possible 
d'interrompre les n boucles les plus internes en utilisant la syntaxe suivante : 

continue N 

Cette possibilite est illustree a l'exemple 3-15, qui contient trois boucles for imbriquees 
(reperes ©, © et ©). La plus interne contient une instruction i f qui stoppe les iterations 
en cours pour les trois boucles si la somme des variables compteur $i, $j et $k est un 
multiple de 3. C'est l'instruction continue 3 (repere ©). Si tel est le cas, l'execution 
passe directement a 1' incrementation de la variable $i, terminant ainsi de maniere anti- 
cipee les iterations des trois boucles en cours. 

Exemple 3-15. Interruption de plusieurs boucles 

<?php 

for ($i=0;$i<10;$i++) <-© 

{ 

for ($j=0;$j<10;$j++) <^© 
{ 
for ($k=0;$k<10;$k++) <-© 
{ 
if(($i+$j+$k)£3==0) continue 3; <-© 
echo "$i : $j : $k <br /> "; 



Gestion des erreurs 

Un bon script ne devrait theoriquement pas generer d'erreur. Certaines erreurs sont inevi- 
tables comme celles qui sont dues a des problemes de connexion defaillante ou de bogue 
sur le serveur. Nous nous interessons ici davantage aux erreurs qui peuvent etre provo- 
quees par des actions de l'utilisateur comme des saisies erronees qui provoquent l'arret 
du script ou encore a celles qui peuvent survenir lors de la tentative d' acces a une ressource 
inexistante. 

La gestion des erreurs a pour but de signaler « proprement » les problemes au visiteur et 
d'eviter l'affichage des messages d'erreur bruts tels que PHP les envoie au navigateur. 
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Suppression des messages d'erreur 

Si vous ecrivez le code ci-dessous : 



<?php 

$a=10; 

$b=0; 

echo $a/$b; <— Q 

fopen( "inconnu.txt" 

?> 



^0 



les messages suivants apparaissent : 

Warning: Division by zero in c:\wamp5\www\php5\c3instructions\instruct3.15a.prip 
*on line 4 

Warning: fopen(inconnu.txt) [function. fopen] : failed to open stream: No such file or 
^•directory in c:\wamp5\www\php5\c3instructions\instruct3.15a.php on line 5 

Le premier message correspond a la division par (repere ©). et le second a la tentative 
d'ouverture d'un fichier qui n'existe pas (repere ©). Ces messages affiches dans le cours 
d'une page HTML sont du plus mauvais effet pour les visiteurs du site. 

Pour eviter l'affichage des messages d'erreur de PHP dans le navigateur, il existe les 
moyens elementaires suivants : 

• Faire preceder l'appel d'une fonction du caractere @ en ecrivant par exemple 

@fopen( "inconnu.txt" , "r" ). 

• Utiliser la fonction error_reporting( ), qui permet de n'afficher que certains messages 
selon le type d'erreur. Sa syntaxe est int error^reporting ( [int niveau]) . C'est le 
parametre niveau qui permet de choisir le niveau d'affichage des messages d'erreur. 
Ses principales valeurs sont indiquees au tableau 3-1. Vous pouvez combiner plusieurs 
valeurs avec 1' operate ur | , comme dans le code suivant : 

error_reporting(E_WARNING | E_PARSE) ; 

qui permet de n'afficher que les alertes et les erreurs de syntaxe. Pour bloquer tous les 
messages d'erreur, il faut passer a la fonction le parametre 0. Cette fonction doit etre 
utilisee des le debut du script. 

Tableau 3-1 - Liste des niveaux d'erreur courants 



Constante 


Valeur 


Niveau d'affichage 


E_ERR0R 


1 


Erreur fatale qui provoque I'arret du script, par exemple, l'appel d'une fonction qui 
n'existe pas. 


E_WARNING 


2 


Avertissement ne provoquant pas I'arret du script, par exemple, une division par 0. 


E_PARSE 


4 


Erreur de syntaxe detectee par I'analyseur PHP et provoquant I'arret du script, par 
exemple I'oubli du point-virgule en fin de ligne. 


E_N0TICE 


8 


Avis que le script a rencontre un probleme simple qui peut ne pas etre une erreur. 


E_ALL 


4095 


Toutes les erreurs 
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II est evident que pendant la phase de developpement des scripts, ces methodes doivent 
etre desactivees pour permettre au programmeur d'etre alerte sur les causes et la localisa- 
tion des erreurs. 

Gestion des exceptions 

Une exception est un mecanisme qui permet d'intercepter une erreur generee par un 
script et de declencher une action en reponse a cette erreur. Si PHP 4 ne permettait pas 
d'effectuer une gestion des exceptions, la version 5 fournit un mecanisme qui permet de 
gerer les consequences d'une erreur. 

La classe Exception 

Si vous n'etes pas familiarise avec les notions de classe ou d'objet, ainsi que de propriete 
et de methode, reportez vous au chapitre 9 pour acquerir ces quelques notions de base. 

PHP 5 introduit la classe predefinie Exception qui offre une gestion evoluee des excep- 
tions. 

Gerer une exception consiste a delimiter un ou des blocs de code et a prevoir une action 
particuliere qui doit etre realisee dans le cas ou 1' erreur prevue se produit. Ces blocs consti- 
tuent les gestionnaires d'exception. Pour les creer, procedez de l'une des facons suivantes : 

• Creez un bloc a l'aide de l'instruction try qui delimite le code dans lequel peut surve- 
nir une erreur. II peut s'agir, par exemple, du code qui gere les saisies faites par des 
utilisateurs dans un formulaire (voir le chapitre 6). Ce bloc contient une instruction 
throw pour declencher 1' exception en creant un objet de type Except i on a l'aide du mot- 
cle new. 

• Creez un bloc a l'aide de l'instruction catch associee au bloc try precedent. II 
comporte le code qui va gerer l'erreur si elle se produit. C'est ce bloc qui utilise l'objet 
Exception cree par l'instruction throw. Si aucune erreur ne se produit dans le bloc try, 
l'objet Exception n'est pas cree, et le code du bloc catch est ignore. L'execution se 
poursuit dans tous les cas apres le bloc catch. 

Un gestionnaire d'exception a done le structure suivante : 

try 
{ 

//Code a surveiller 

if(erreur prevue) {throw new Exceptiont ) ; } 

else{// Resultat;} 
} 

catch(Exception $except) 
{ 

//Gestion de 1 'erreur 
} 

Le nom de l'objet utilise dans l'instruction catch est sans importance. Un meme script 
peut comporter autant de bloc try...catch que vous voulez. II est egalement possible 



PHP 5 



d'imbriquer des blocs try les uns dans les autres, a condition que chacun ait un bloc catch 
associe. 

Le constructeur de l'objet Exception cree dans l'instruction throw recoit deux parametres, 
correspondant aux proprietes message et code de l'objet. Le premier est une chaine conte- 
nant le message d'erreur et le second un entier qui definit un code d'erreur facultatif. Cet 
objet est utilise dans le bloc catch en appelant ses methodes pour afficher des informa- 
tions sur 1' exception. Le tableau 3-2 donne la liste et le role des methodes de l'objet 
Exception. 

Tableau 3-2 - Les methodes de l'objet Exception 

Methode Definition 

construct ) Constructeur de l'objet. II est appele automatiquement lors de la creation d'un objet avec le 

mot-cle new. II definit les proprietes message et code de l'objet. Cette methode ne doit pas 
etre appelee explicitement. 

getMessage( ) Retourne la valeur de la propriete message dans une chaine. 

getCode( ) Retourne la valeur de la propriete code sous la forme d'un entier. 

getFileO Retourne la valeur de la propriete file qui contient le nom et le chemin d'acces du fichier 

dans lequel s'est produite I'erreur. 

getl_ine( ) Retourne la valeur de la propriete line qui indique le numerode ligne a laquelle a ete creee 

I'exception. 

toStringO Retourne une chaine contenant toutes les informations sur I'exception. 



L'exemple 3-16 presente une premiere mise en oeuvre du mecanisme des exceptions et 
des methodes ci-dessus. Vous y definissez deux variables dans le but d' afficher le resultat 
de la division (reperes O et ®)- Ces valeurs proviendraient en pratique des saisies d'un 
utilisateur. L'absence de gestion de I'erreur provoquerait l'affichage d'une alerte 
(Warning). Supprimer l'affichage de cette alerte en utilisant la fonction error_ 
reporting ( ) avec le parametre laisserait l'utilisateur dubitatif car le resultat attendu ne 
serait pas affiche, et ce sans aucune explication. 

Vous creez done un bloc try (repere ©) pour gerer ce type d'erreur. Le controle de la 
valeur de la division permet de declencher une exception en definissant un message 
approprie et un code d'erreur (repere ©). Si la valeur de $b etait valide, le resultat de la 
division serait affiche normalement, et le bloc catch serait ignore (repere ©). 

Comme ici $b vaut 0, le bloc catch (repere ©) affiche successivement le message 
d'erreur (repere Q). le nom du fichier dans lequel se produit I'erreur (repere ©), la ligne 
de l'instruction throw a laquelle l'objet Sexcept a ete cree (repere ©), le code d'erreur 
(repere©) et les informations sur I'exception (repere©). L'affichage du mot "FIN" 
prouve que l'execution du script continue normalement, que le bloc catch soit execute ou 
non (repere ©). 
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Exemple 3-16. Creation d'un gestionnaire d'exception 

<?php 

$a=100; <-0 

$b=0; <-© 

try ^© 

{ 
if ($b==0){throw new ExceptionC'Division par 0",7);}<— 
elsefecho "Resultat de : $a / $b = ",$a/$b;}<— 

} 

catch(Exception Sexcept) <— 

{ 
echo "Message d'erreur : " ,$except->getMessage( ) ,"<hr>" ; <— 
echo "Norn du fichier : " ,$except->getFile( ) , "<hr>" ; <— 
echo "Numero de ligne : " ,$except->getl_ine( ) ,"<hr>" ; <— 
echo "Code d'erreur : " ,$except->getCode( ) , "<hr>" ; <— © 
echo " toString :",$except-> toStringt ) , "<hr>" ; <— 



La figure 3-4 montre le resultat obtenu. 



echo "FIN"; 
?> 
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Figure 3-4 

Affichages crees par I 'objet Exception 

Cet exemple n'a pour but que d'illustrer l'utilisation des methodes de l'objet Exception. 
En production, vous n'afficheriez pas toutes ces informations, qui n'interessent pas le 
visiteur. 
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Vous allez done modifier ce script pour afficher une boite d'alerte signalant simplement 
le probleme a l'utilisateur. L'exemple 3-17 montre les modifications operees. Dans le 
bloc catch, vous creez une boite d'alerte utilisant la fonction JavaScript al ert( ), qui affi- 
che uniquement le message et le code d'erreur (repere Q '- 

Exemple 3-17. Affichage pour le visiteur 

<?php 

$a=10; 

$b=0; 

try 

{ 

if($b==0) {throw new ExceptionCDivision par 0",7);} 

elsefecho "Resultat de : $a / $b = ",$a/$b;} 
} 

catch( Exception Sexcept) 
{ 

echo "<script type=\"text/javascript\"> alert(' Erreur n" 

*»",$except ->getCode( ) ," \\n ",$except ->getMessage( ) ," 
} 

echo "FIN"; 
?> 



) </script> "; ^O 



[JavaScript Application] 
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Figure 3-5 

Message d'erreur pour le visiteur 



Personnalisation de I'objet Exception 

Le mecanisme de l'heritage (voir le chapitre 9) permet d'etendre une classe pour lui ajou- 
ter des methodes ou des proprietes. Vous pouvez done enrichir I'objet Exception avec de 
nouvelles methodes. II serait meme envisageable de creer des objets personnalises 
permettant de gerer des types d'erreurs specifiques. 

L'exemple 3-18 illustre cette possibilite d'extension en creant une classe qui herite de la 
classe Exception (repere ©)• Une nouvelle methode, nommee alerte()(repere ©), est 
ajoutee pour creer une boite d'alerte JavaScript. Le simple appel de la methode al erte( ) 
pour I'objet MonException retourne le code qui cree cette boite (repere 0) sans avoir a 
reecrire systematiquement ce code dans chaque script a chaque utilisation. 

Pour montrer qu'un meme bloc try peut gerer plusieurs erreurs differentes, vous creez 
deux conditions if qui correspondent a des situations differentes. La premiere declenche 
une exception si $b vaut (repere ©), et la seconde une autre exception si le resultat de 
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$a/$b n'est pas un entier, c'est-a-dire si $a n'est pas un multiple entier de $b (repere @). 
En fonction de la valeur de $b, l'appel de la methode al erte( ) contenue dans le bloc catch 
(repere Q) de l'objet de type Mon Except ion qui sera cree affiche une boite d'alerte identi- 
que a celle de la figure 3-5 (si $b vaut 0) ou celle de la figure 3-6 (comme c'est le cas dans 
l'exemple ou $b vaut 3). 



Exemple 3-18. Exception personnalisee 

<?php 

//Creation d'un classe derivee de Exception 

class MonException extends Exception <— O 

{ 

public function alerte()<— Q 

{ 
$this->message ="<script type=\"text/javascript\"> alert(' Erreur n' ".$this-> 
^•getCodeO." \\n " .$this->getMessage( ) ." ' )</script> " ; <— © 
return $this->getMessage( ) ; <— Q 

} 
} 

//Utilisation de la classe 
$a=100; 
$b=3; 
try 
{ 

if($b == 0) {throw new MonException( "Division par ",7);}<— Q 

elseif($a&$b ! = 0) {throw new MonExceptionCQuotient entier impossible" ,55) ;) <— ® 

elsefecho "Resultat de : $a / $b = ",$a/$b;} 
} 

catchtMonException $except) 
{ 

echo $except->alerte( ) ; <— Q 
} 

echo "FIN"; 
?> 
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Figure 3-6 

Affichage pour une erreur de divisibilite 



Vous pouvez envisager de creer un grand nombre d'objets personnalises permettant de 
gerer rapidement et d'une maniere adaptee toutes sortes d'erreurs de types tres differents. 
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Exercices 



Exercice 1 

Redigez une expression conditionnelle pour tester si un nombre est a la fois un multiple 
de 3 et de 5. 

Exercice 2 

Ecrivez une expression conditionnelle utilisant les variables $age et $sexe dans une 
instruction if pour selectionner une personne de sexe feminin dont l'age est compris 
entre 21 et 40 ans et afficher un message de bienvenue approprie. 

Exercice 3 

Effectuez une suite de tirages de nombres aleatoires jusqu'a obtenir une suite composee 
d'un nombre pair suivi de deux nombres impairs. 

Exercice 4 

Creez et affichez des numeros d'immatriculation automobile (pour Paris, par exemple) 
en commencant au numero 100 PHP 75. Effectuez ensuite la meme procedure en mettant 
en reserve les numeros dont le premier groupe de chiffres est un multiple de 100. Stockez 
ces numeros particuliers dans un tableau. 

Exercice 5 

Choisissez un nombre de trois chiffres. Effectuez ensuite des tirages aleatoires, et comp- 
tez le nombre de tirages necessaire pour obtenir le nombre initial. Arretez les tirages, et 
affichez le nombre de coups realises. Realisez ce script d'abord avec 1' instruction while 
puis avec 1' instruction for. 

Exercice 6 

Creez un tableau dont les indices varient de 1 1 a 36 et dont les valeurs sont des lettres de 
A a Z. Lisez ensuite ce tableau avec une boucle for puis une boucle foreach, et affichez 
les indices et les valeurs (la fonction chr( n ) retourne le caractere dont le code ASCII vaut 
n). 

Exercice 7 

Utilisez une boucle whi 1 e pour determiner le premier entier obtenu par tirage aleatoire qui 
soit un multiple d'un nombre donne. Ecrivez la variante utilisant la boucle do...whi 1 e. 

Exercice 8 

Recherchez le PGCD (plus grand commun diviseur) de deux nombres donnes. Gerez au 
moyen d'une exception le cas ou au moins un des nombres n'est pas entier. 
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Les chaines de carac teres 



Dans un site Web, vous manipulez constamment des chaines de caracteres, qui constituent 
l'essentiel du contenu de la plupart des pages. Quand le contenu est cree dynamiquement 
a partir de fichiers ou d'une base de donnees, ce sont encore pour une part importante des 
chaines de caracteres qui sont manipulees. De plus, toutes les variables issues de l'envoi 
d'un formulaire par le poste client sont de type string. 



Affichage des chaines 

Vous avez vu a l'ceuvre a plusieurs reprises la fonction echo pour afficher des donnees. 
Cette fonction est utilisable de plusieurs facons quand il s'agit d'afficher plusieurs 
chaines ou variables a la suite l'une de l'autre afin de ne pas multiplier les appels a 

echo. 

Vous pouvez utiliser l'operateur de concatenation entre chaque expression, comme dans 
l'exemple suivant : 

I$nom = "Schultz"; 
echo "Bonjour Monsieur ". $nom. " nous sommes le ". date('d'); 

Dans le code, vous realisez successivement la concatenation d'une chaine litterale, d'une 
variable de type string, d'une deuxieme chaine puis de la valeur retournee par une fonc- 
tion, qui est ici de type string. Apres quoi, echo affiche l'ensemble dans le navigateur. 

Le meme resultat pourrait etre obtenu sans concatenation, en separant chaque expression 
par une virgule, comme ci-dessous : 



echo "Bonjour Monsieur ", $nom," nous sommes le " ,date( 'd' ) ; 
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II n'est pas possible d'inclure de fonction dans une chaine unique, comme ci-dessous : 

echo "Bonjour Monsieur $nom nous sommes le date('d')" ; 
Si la variable $nom est bien evaluee, la fonction date( ) ne pourrait pas l'etre. 
La « fonction » print( ) est quasiment similaire a echo. Vous pouvez ecrire, par exemple : 

print ("Bonjour Monsieur $nom nous sommes le ". date('d') ); 
ou : 

print ("Bonjour Monsieur $nom nous sommes le "). date('d'); 
Dans ces deux cas, vous obtenez la valeur retournee par la fonction date( ). 



Affichage formate 



Un affichage formate permet d'obtenir des resultats uniformes, par exemple, pour aligner 
des chaines sur plusieurs lignes ou des nombres dans un format particulier, comme un 
nombre de decimales fixe et une superposition correcte des chiffres en colonnes pour des 
montants financiers. 

Vous disposez de deux fonctions pour cela, printfO etsprintfO. 

La syntaxe de printf ( ) est la suivante : 

| void printf (string "format", string $chl, string $ch2, $chN) 

Cette fonction affiche directement le contenu des chaines $chl, $ch2, ..., $chN selon le 
format specifie dans la chaine "format". 

La syntaxe de sprintf ( ) est la suivante : 

string sprintf (string "format" .string $chl, string $ch2 SchN) 

Elle retourne une chaine unique, qui peut etre composee de une ou plusieurs fois les 
chaines $chl, $ch2, ..., $chN formatees selon le modele defini dans la chaine "format", 
comme precedemment. 

Les fonctions vprintf et vsprintf, dont la syntaxe est la suivante : 

I void vprintf (string "format" , array Stab) 
string vsprintf ( string "format", array $tab) 

jouent des roles equivalant respectivement a printf ( ) et sprintf ( ), mais avec pour parti- 
cularite que les chaines sont passees en argument dans un tableau. 

Le plus difficile est ici de bien definir la chaine de formatage. Celle-ci peut etre composee 
d'un texte ordinaire, generalement explicatif, et de directives d' affichage. Ces dernieres 
sont constituees de caracteres speciaux qui indiquent la maniere dont les variables 
passees en parametre doivent etre incorporees dans la chaine. C'est cette chaine qui est 
affichee directement ou retournee, selon la fonction utilisee. 
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Les directives d'affichage sont composees, dans l'ordre, du caractere % suivi de : 

• Un caractere de remplissage, utilise pour completer la chaine quand on lui impose une 
longueur fixe. Pour definir un caractere autre que ou l'espace (valeur par defaut), il 
faut le prefixer par une apostrophe ( ' )• 

• Un caractere moins (-), pour indiquer un alignement a droite. Par defaut, l'alignement 
se fait a gauche. 

• Un nombre, indiquant le nombre de caracteres pour la chaine formatee. 

• Un point suivi d'un en tier, indiquant le nombre de decimales a afficher pour les decimaux. 

• Une lettre, indiquant la specification du type de la valeur a afficher. Le tableau 4-1 donne 
la liste et les definitions de ces caracteres. 

Tableau 4-1 - Les caracteres de formatage du type de donnee 

1 

Caractere Signification 

%b Interprete la chaine $ch comme un entier et I'affiche en binaire : 

$ch="89"; 

printf ("En binaire $ch s'ecrit %b <br />", $ch) ; 
//Affiche :En binaire 89 s'ecrit 1011001 

%c Interprete la chaine $ch comme un entier et affiche le caractere dont le code ASCII correspond a 

ce nombre : 
$ch="115"; 

printf (" Le caractere de code $ch est %c <br />", $ch); 
//Affiche: Le caractere de code 115 est s 



%d 


Interprete la chaine $ch comme un entier signe et 
$ch = "-25"; 


'affiche comme un nombre en base 10 : 




printf ("La valeur de \$ch est %&" , $ch) 


//Affiche -25 



%f Interprete la chaine $ch comme un nombre de type double et I'affiche avec sa partie decimale a 6 

chiffres. Les caracteres non numeriques de $ch ne sont pas pris en compte : 
$ch = "25.52 metres"; 
printf ("La longueur est de %f m", $ch); 
// Affiche: La longueur est de 25.520000 m 

%o Interprete le chaine $ch comme un entier et I'affiche en octal : 

$ch = 252; 

printf ("En octal le nombre $ch s'ecrit %o" , $ch); 
// Affiche: En octal le nombre 252 s'ecrit 374 

%s Interprete $ch comme une chaine et I'affiche telle quelle : 

$chl = "Monsieur " ; $ch2 - " Schtroumpf" ; 
sprintf ("Bonjour.Xs %s bravo ! " , $ c h 1 $ch2); 
Equivaut a : 
echo "Bonjour $chl $ch2, bravo !"; 

%x Interprete la chaine $ch comme un entier et I'affiche en hexadecimal en minuscules (%x) ou (%X) : 

ou $ch ="252756"; 

%X printf ("En hexadecimal $ch s'ecrit Xx. ", $ch) ; 

// Affiche: En hexadecimal 252756 s'ecrit 3db54 
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Specifier le type 

La chaine doit contenir au minimum la specification du type selon lequel la chaine doit etre traitee (entier, 
decimal, octal, hexadecimal, binaire, double ou chaine). 



L'exemple 4-1 presents une application des fonctions de formatage des chaines qui affi- 
che les lignes d'une facture et permet d' aligner tous les montants HT, TVA et TTC de 
chaque article sur plusieurs lignes. La premiere fonction, sprintfO, retourne la chaine 
des en-tetes affichee avec echo (repere Q). La chaine de formatage utilise un caractere de 
remplissage et un specificateur de longueur. 

Le prix HT de chaque article est contenu dans un tableau (reperes QQ et 0). Chaque 
prix est lu par une boucle for contenant la seconde fonction sprintfO, qui permet 
d'aligner correctement les montants, quelle que soit leur longueur (reperes © et ©). Un 
dernier appel a sprintfO retourne la ligne des totaux de chaque colonne (repere©). 
L'utilisation de la fonction str_repeat() permet de creer une chaine contenant la repeti- 
tion de Nfois la meme chaine $ch, sans avoir a multiplier les appels a echo (repere ©). 

La syntaxe de str_repeat( ) est la suivante : 

string str_repeat (string $ch, int N) 

La figure 4-1 illustre le resultat de ce script. 

Exemple 4-1. Utilisation de specificateurs 



<?php 

echo"<h3>Votre facture </h3>"; 
echo sprintf("<b>r_25s %'_25s 
'•"Prix T.T.C."); <-© 
$ht[l] = 27.55 ; <^0 
$ht[2] = 3450.40 ; <-© 
$ht[3] = 320.75 ; <-© 



25s <br /></b>","Prix H.T. 



"T.V.A. 



for($i=l;$i<4;$i++) <-© 



{ 



echo sprintf ("%'_20.2f %' 
*$ht[$i]*1.196); <-© 
$total+=$ht[$i]; 



_22.2f %'_20.2f <br />" ,$ht[$i ] ,$ht[$i ]*0.196, 



echo str_repeat("*",71) ,"<br />";<—© 

echo sprintf ("%'_20.2f r_22.2f %'_20.2f <br />" Jtotal ,$total*0.196, 

*$total*1.196); <-© 

?> 

Si le nombre de parametres de type stri ng est important, il est possible de les placer dans 
un tableau et de passer ce tableau comme deuxieme parametre a l'aide des fonctions 
vprintf ( ) et vsprintf ( ), dont la syntaxe respective est la suivante : 

[void vprintf (string "format", array $tab) 
string vsprintf (string "format", array Stab) 

Ces fonctions equivalent respectivement aux fonctions printfO et sprintfO. 
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-1 http://127.0.0.1/php5/C4chaines/stnng1.php 
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Figure 4-1 

Formatage de V affichage 



Ordre de passage 

La fonction sprintf ( ) incorpore les chaines passees en parametre dans I'ordre de leur passage. Vous 

pouvez modifier cet ordre ainsi que reutiliser la meme valeur sans avoir a passer plusieurs fois le meme 

parametre. 

Le code ci-dessous illustre cette possibilite. La chaine de formatage du deuxieme appel a spri ntf ( ) fait 

reference au premier parametre en ecrivant "Xl\$s" et "%2\$s" pour le second : 

$chl = "Monsieur " ; 

$ch2 = " Rasmus" ; 

echo sprintf ("Bonjour %s %s, bravo ! " ,$chl ,$ch2) ; 

//Affiche: Bonjour Monsieur Rasmus, bravo ! 

echo sprintf ("Bonjour £2\$s , bravo 21\$s! " ,$chl ,$ch2) ; 

//Affiche: Bonjour Rasmus , bravo Monsieur ! 



Longueur d'une chaine et codes des caracteres 

Pour determiner le nombre de caracteres d' une chaine, utilisez la fonction strl en ( ) , dont 
la syntaxe est la suivante : 

int strlen (string $ch) 

Le parametre unique peut aussi bien etre une variable de type stri ng ou une chaine litte- 
rale entre guillemets. 

La fonction strl en ( ) peut servir, par exemple, a verifier qu'un code postal saisi par un 
internaute comporte bien cinq caracteres en ecrivant : 

I$code = "7508" ; 
if (strlen($code) != 5) echo "Code errone !" ; 
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Pour verifier qu'il s'agit bien de cinq chiffres et non pas de cinq caracteres quelconques, 
il faut utiliser une expression reguliere (voir la section « Les expressions regulieres » 
dans ce chapitre). 

Vous pouvez aussi afficher separement chaque caractere d'une chaine a l'aide d'une 
boucle. Une chaine est en fait assimilable a un tableau (voir le chapitre 5), dont chaque 
lettre est un element. Vous pouvez done lire chaque lettre en utilisant la notation a 
crochets des tableaux. 

Le code suivant affiche chaque lettre verticalement en realisant une boucle for dont la 
condition d' arret est determinee par strl en( ) : 

I Slang = "PHP 5" ; 
for ($i =0;$i< strlen ($1 ang) ;$i++) 
{echo "<hl> $lang[$i] </hl>";} 

Vous pouvez retrouver le code Unicode d'un caractere a l'aide de la fonction ord( ) et, 
reciproquement, obtenir le caractere a partir de son code a l'aide de la fonction chr( ). 

La syntaxe de ces fonctions est la suivante : 

Iint ord (string car) 
string chr (int code) 

L'exemple 4-2 cree un mot de passe compose de cinq lettres, dont les codes Unicode 
compris entre 65 et 90 sont generes aleatoirement par la fonction randO (repere ©). 
Chaque lettre est creee a partir de son code puis concatenee dans la variable $code 
(repere ©), apres quoi le mot de passe est affiche (repere ©). 

Exemple 4-2. Creation d'un mot de passe litteral 

<?php 

for($i=l;$i<6;$i++) 

{ 

$nb=rand(65,90); <-Q 

$code.=chr($nb); <— Q 
} 

echo "Votre mot de passe est : ",$code;<— Q 
?> 



Mise en forme des chaTnes 

II est souvent necessaire de remettre en forme les chaines utilisees dans les scripts, 
notamment lorsqu'elles emanent d'une source exterieure, comme les saisies faites par 
des visiteurs dans un formulaire. 



Modification de la casse 

PHP offre plusieurs fonctions de conversion de la casse d'une chaine utilisables pour 
normaliser l'affichage, quelle que soit la casse utilisee par un visiteur pour saisir des 
informations. II s'agit des fonctions strtolower, strtoupper, ucwords et ucfirst. 
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| string strtolower(string $ch) 

retourne la chaine avec tous les caracteres en minuscules. 
| string strtoupper(string $ch) 
retourne la chaine avec tous les caracteres en majuscules. 

string ucwordststring $ch) 
retourne la chaine avec toutes les initiales des mots qui la composent en majuscules. 

string ucfirsttstring $ch) 
retourne la chaine avec uniquement la premiere lettre en majuscule. 

Pour realiser un affichage conforme aux usages, vous pouvez combiner plusieurs de ces 
fonctions pour eliminer les fantaisies eventuelles des differents utilisateurs, par exemple 
pour realiser un affichage sur une page ou enregistrer ces donnees dans une base de donnees. 
Par exemple, si la saisie fantaisiste est "jEaN EngelS", utilisez d'abord strtolower( ) pour 
transformer le texte en minuscules puis ucwords( )pour mettre les initiales en majuscules. 

L'exemple 4-3 utilise les fonctions precedentes pour realiser un affichage normalise a 
partir de chaines ayant des casses heteroclites. 

Exemple 4-3. Normalisation de la casse des chaines 

<?php 

$nom - "ENgelS" ; 

$prenom = "jEan " ; 

$adresse = "21, rue compoinT" ; 

$ville = "75018 pAris" ; 

$mail = "ENGELS@funPHP.Com" ; 

$prenom = ucfirst (strtolower ($prenom )) ; 

$nom - strtoupper ($nom) ; 

$adresse = ucwordststrtolower ($adresse )) ; 

$ville = strtoupper ($ville); 

$mail = strtolower ($mail); 

echo "Mes coordonnees <br />"; 

echo Sprenom, $nom, "<br />"; 

echo $adresse, "<br />" ; 

echo $ville, "<br />" ; 

?> 

Le script fournit 1' affichage standard suivant : 

Mes coordonnees 
Jean ENGELS 
21, rue Compoint 
75018 PARIS 

Les utilisateurs peuvent done saisir leurs coordonnees dans un formulaire dans la casse 
de leur choix. Les resultats, quant a eux, auront tous la meme presentation. 
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Gestion des espaces 

De meme, dans le but de realiser un affichage uniforme a partir de saisies des utilisateurs 
ou de stacker ces dernieres dans une base de donnees, il peut etre utile de supprimer les 
caracteres d'espaces inutiles en debut et en fin de chaine. 

Vous disposez pour cela des trois fonctions, 1 trim, rtrim et trim. 

string ltrim (string $ch [.string liste]) 
renvoie la chaine $ch nettoyee des espaces situes en debut de chaine. 

string rtrim (string $ch [.string liste]) 
supprime les espaces situes en fin de chaine. 

string trim (string $ch [.string liste]) 

supprime les espaces situes en debut et en fin de chaine. 

Le parametre liste permet de definir une liste de caracteres a supprimer, qu'ils soient des 
caracteres d'espacement ou des caracteres quelconques. 

Le code suivant supprime les points situes au debut et l'espace situe a la fin de la chaine 
$a ainsi que les caracteres de soulignement situes a la fin de la chaine $b : 

<?php 

$a = " . . .Jean " ; 

$b - "Dupont "; 

echo $a,$b,"<br />"; 

echo trim($a,' .')," " ,rtrim($b, ' _'); 

?> 

Les resultats affiches sont : 

. . .Jean Dupont 

Jean Dupont 

Dans le meme ordre d'idee, la fonction wordwrap( ) permet d'afficher un texte long avec 
une largeur maximale determinee. Sa syntaxe est la suivante : 

string wordwrap ( string $ch [, int N [, string car [, boolean coupe]]]) 

Le parametre N definit cette largeur et car contient la chaine a inserer dans $ch tous les N 
caracteres. Le parametre booleen coupe, permet, s'il vaut TRUE, d'effectuer une cesure des 
mots dont la longueur depasse N caracteres. 

Avec le code suivant : 

echo wordwrap($ch,30,"<br />",1); 

le contenu de la chaine $ch s'affiche dans une colonne de 30 caracteres de largeur. Dans 
le code source XHTML, vous trouvez done un element <br /> tous les 30 caracteres. 
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Entites XHTML et caracteres speciaux 

Pour ajouter automatiquement le caractere d'echappement \ devant les caracteres 
speciaux tels que apostrophe ('), guillemets ("), antislash (\) et le caractere NUL, vous 
devez utiliser la fonction addsl ashes( ), dont la syntaxe est la suivante : 

string addslashes (string $ch) 

Cette fonction peut etre utilisee avant d'enregistrer des chaines dans une base de donnees. 
Reciproquement, la fonction stri psl ashes ( ) enleve les caracteres d'echappement. 

Par exemple, le code suivant : 

$ch="Le repertoire est : 'C:\PHP_doc\php5'"; 

$ch = addslashes($ch) ; 

echo $ch; 

$ch =stripslashes($ch) ; 

echo $ch; 

affiche la chaine $ch apres chacune de ces transformations : 

Le repertoire est : \'C:\\PHP_doc\\php5\' 
Le repertoire est : 'C:\PHP_doc\php5' 



Donnees de formulaire 

La fonction addsl ashes () est inutile pour les donnees en provenance d'un formulaire si la directive 
magic_quotes_runtime est active dans le php.ini. 



La fonction quotemeta( ) est similaire a addslashes( ), a la difference pres qu'elle introduit 
un caractere d'echappement devant les metacaracteres ., \, +, *, ?, [, ], (, ), $ et A . Sa 
syntaxe est la suivante : 

string quotemeta ( string $ch) 

Pour creer du code XHTML ou XML, vous devez transformer certains caracteres 
speciaux (&, ", ', <, >) en entites de caracteres. Vous utilisez pour cela la fonction 
html special charsO, dont la syntaxe est la suivante : 

I string htmlspecialchars (string $ch [, int CTE[, string charset]]) 

Le parametre CTE est une constante qui determine le traitement des guillemets. Elle prend 
les valeurs suivantes : 

• ENT_COMPAT ou 2 (valeur par defaut) convertit les guillemets doubles mais pas les guille- 
mets simples. 

• ENT_QUOTES ou 3 convertit les guillemets doubles et simples. 

• ENUOQUOTES ou ne traite aucun des guillemets. 

Le parametre charset designe le jeu de caracteres utilise. Par defaut, il s'agit de ISO- 
8859-1. 



PHP 5 



La fonction html entiti es ( ), dont la syntaxe est la suivante : 

j string html entities (string $ch [, int CTE[, string charset]]) 

retoume une chaine dans laquelle tous les caracteres speciaux en XHTML, done tous 
ceux dont le code UNICODE est superieur a 128, en entites de caractere interpretables 
par les navigateurs. 

Les parametres CTE et charset ont les memes significations que dans la fonction 
htmlspecialchars( ). Appliquee aux saisies des visiteurs, cette fonction empeche la crea- 
tion intempestive de code XHTML en cas de saisie de balises dans une zone de texte. 

Dans le code suivant : 

$ch = "Cliquez sur l'icone en tete pour demarrer" ; 

$ch2 = "L'element XHTML du bouton est <button>" ; 

echo htmlentities($ch) ; 

echo "<br />"; 

echo htmlentities($ch2) ; 

Si vous ecrivez "echo $ch2 ; " vous obtenez un bouton dans la page alors qu'en appelant 
htmlentitiesO le code apparait normalement. Le code source du fichier XHTML 
contient les lignes suivantes : 

Cliquez sur 1 'ic&oci rc;ne en tête pour démarrer<br /> 
L'élément XHTML du bouton est &1 t;button> 

Pour realiser l'operation inverse, e'est-a-dire transformer les entites en caracteres ordi- 
naires, vous devez faire appel a la fonction suivante : 

string html_entity_decode (string $ch [, int CTE[, string charset]]) 

qui possede les memes parametres. 

Pour transformer les sauts de lignes "\n" d'une chaine en sauts de ligne XHTML <br />, 
utilisez la fonction nl 2br( ). Elle permet d'ameliorer la presentation des textes saisis dans 
les zones multilignes (voir le chapitre 6). 

Le code suivant affiche la chaine $ch sur trois lignes : 

|$ch = "Voici une ligne \n puis une autre \n Fin\n" ; 
echo nl2br($ch) ; 

Nous avons deja signale que, dans un site dynamique, de nombreuses chaines prove - 
naient de saisies operees par les visiteurs et enregistrees ensuite pour etre affichees sous 
une forme quelconque dans une page XHTML. 

Imaginez qu'une personne mal intentionnee saisisse la chaine $ch suivante dans un 
formulaire afin qu'elle soit enregistree et reutilisee par la suite : 

$ch="<script type= text/javascript> alert( 'Sal ut ' ) ; history .back( ) ; </script>"; 

Si le site doit utiliser cette chaine pour rafficher avec une instruction echo, la page ainsi 
creee est inutilisable car le navigateur affiche d'abord une boite d'alerte JavaScript, creee 
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par la fonction alertO. L'utilisateur est ensuite redirige automatiquement vers la page 
precedente par la fonction hi story. backO. La page n'est done jamais visible. 

Pour eviter ces problemes, il est possible d'enlever les balises XHTML d'une chaine 
grace a la fonction strips_tags(), dont la syntaxe est la suivante : 

| string strip_tags ( string $ch [, string balise_ok]) 

La fonction retourne la chaine $ch debarrassee des balises d'ouverture et de fermeture des 
elements XHTML autres que ceux qui sont precises dans le deuxieme parametre comme 
etant acceptes. 

Par exemple, dans le code suivant : 

$ch="<script type =text/javascript> alert( 'Sal ut' ) ; history .back( ) ; </script>"; 
//echo $ch; ^O 
$ch=strip_tags($ch); <— © 
echo $ch; <— © 

si vous decommentez la deuxieme ligne (repere ©). vous vous exposez au probleme 
signale ci-dessus, alors qu'en appliquant la fonction strip_tags( ) a $ch (repere ©) puis 
en affichant la chaine $ch modifiee (repere ©), la page ne contient que l'affichage : 

alert ( 'Salut' ) ; hi story. back( ) ; 

Tout en etant parasite, cet affichage n'est pas dangereux. 



Recherche de sous-chaTnes 

Une chaine pouvant etre consideree comme un tableau de caracteres (indice de a N), 
vous pouvez recuperer le caractere d'indice /Ven ecrivant $ch[N] ou $ch[$N] si la variable 
$N contient un entier. 

Le code suivant : 

|$ch = "Bonjour Genevieve" ; 
echo "Le 9eme caractere de la chaine $ch est {$ch[8]}" ; 

affiche le caractere G. 

Plusieurs fonctions specifiques permettent d'extraire une sous-chaine d'une chaine 
donnee. La fonction strstrC ) — ou strchr( ), qui en est un alias — , dont la syntaxe est la 
suivante : 

string strstr (string $ch, string $ch2) 

recherche si la chaine $ch2 est contenue dans $ch et retourne tous les caracteres allant de 
la premiere occurrence de $ch2 jusqu'a la fin de $ch. Cette recherche est sensible a la 
casse. Pour effectuer une recherche insensible a la casse, vous devez utiliser la fonction 
suivante : 



string stristr (string $ch, string $ch2) 
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Par exemple, le code suivant : 

|$ch = "Perette et le pot au 1 ait" 
$ssch = strstr ($ch, "pot") 
echo $ssch ; 

affiche la sous-chaine "pot au lait". 

Si $ch2 ne figure pas dans $ch, la fonction retourne FALSE. 

Contrairement a la precedente, la fonction strrchr( ), dont la syntaxe est la suivante : 

string strrchr (string $ch, string $ch2) 

ne retourne que la portion de $ch presente a partir de la derniere occurrence de $ch2. Par 
exemple : 

|$ch = "Perette et le pot au lait. C'est pas de pot !" ; 
$ssch = strrchr($ch, "pot") 
echo $ssch ; 

n'affiche que la sous-chaine "pot ! ". 

Les fonctions suivantes permettent d'extraire des sous-chaines en fonction des indices 
des caracteres dans la chaine analysee (le premier etant a l'indice 0). 

La fonction substr( ), dont la syntaxe est la suivante : 

string substr (string $ch, integer ind [, integer N]) 

retourne la chaine contenant N caracteres de $ ch extraits a partir de 1' indice i nd inclus. Si 
le parametre N est omis, elle retourne la sous-chaine comprise entre l'indice ind et la fin 

de $ch. 

La fonction substr_count() retourne le nombre d'occurrences d'une sous-chaine $ssch 
dans une chaine $ch. Sa syntaxe est la suivante : 

int substr_count (string $ch, string $ssch) 

II est possible de remplacer toutes les occurrences d'une sous-chaine par une autre au 
moyen de la fonction str^repl ace( ) : 

string str_replace(string $chl, string $ch2, string $ch [.string $var]) 

La fonction retourne la chaine $ch, dans laquelle toutes les occurrences de $chl sont 
remplacees par $ch2. Le quatrieme parametre est le nom d'une variable a laquelle est 
passe par reference le nombre de remplacement effectue. Dans 1' exemple 4-6, le mot 
"pot" est remplace par "bol ". 

Exemple 4-5. Extraction et remplacement de sous-chaines 

<?php 

$ch = "Perette et le pot au lait. C'est pas de pot!" ; 

Sssch = substr ($ch, 8, 9) ; 

echo $ssch,"<br />" ; 
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$ssch = substr($ch,8) ; 

echo $ssch ,"<br />"; 

$ch2="pot"; 

$nb=substr_count($ch,$ch2) ; 

echo "Le mot $ch2 est present $nb fois dans $ch <br />" 

$ch3=str_replace( 'pot' , 'bol ' ,$ch) ; 

echo $ch3,"<br />" ; 

?> 

Les resultats affiches sont les suivants : 



et le pot 

et le pot au lait. C'est pas de pot! 

Le mot pot est present 2 fois dans Perette et le pot au lait. C'est pas de pot! 

Perette et le bol au lait. C'est pas de bol! 

2 rempl acements 

La fonction strpos( ) retourne la position du premier caractere de la premiere occurrence 
d'une sous-chaine $ch2 dans $ch ou FALSE si $ch2 ne figure pas dans $ch. 

La syntaxe de la fonction strpos( )est la suivante : 

int strpos (string $ch, string $ch2[,int N]) 

Puisque la fonction retourne FALSE si le mot n'est pas trouve, elle peut permettre indirec- 
tement de detecter la presence d'un mot dans une chaine en la placant dans une condition 
if, ce qui est realise dans l'exemple 4-6 (repere ©). 

Les variantes de cette fonction, aux syntaxes identiques, sont striposO, qui est insensible 
a la casse, strrposO, qui retourne la position de la derniere occurrence trouvee, et 
strripos( ), qui est identique a strrposO mais insensible a la casse. 

Exemple 4-6. Recherche de la position ou de I'existence d'un mot 

<?php 

$ch = "Perette et le pot au lait. C'est pas de pot ! La Fontaine" ; 

echo "\$ch = $ch <br />"; 

$ch2 = "pot" ; 

//recherche sensible a la casse 

$n=strpos ($ch, $ch2); 

echo "Le mot $ch2 commence a la position $n dans \$ch <br />" ; 

//recherche insensible a la casse 

$ch3 = "POT" ; 

$n2=stripos($ch, $ch3); 

echo "Le mot $ch3 commence a la position $n2 dans \$ch <br />" ; 

//recherche de la derniere occurrence sensible a la casse 

$n3=strrpos($ch, $ch2); 

echo "La derniere occurrence du mot $ch2 commence a la position $n3 dans \$ch<br />" 

//recherche sensible a la casse de I'existence d'un mot 
$ch4="fontaine" ; 
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Iifdstrpos ($ch,$ch4)) 
{ echo "Le mot $ch4 n'est pas dans \$ch"; 
?> 

Le resultat affiche est le suivant : 



$ch = Perette et le pot au lait. C'est pas de pot ! La Fontaine 

Le mot pot commence a la position 14 dans $ch 

Le mot POT commence a la position 14 dans $ch 

La derniere occurrence du mot pot commence a la position 40 dans $ch 

Le mot fontaine n'est pas dans $ch 

Les memes conventions de formatage utilisees par la fonction printfO sont utilisables 
pour extraire des sous-chaines et affecter leurs valeurs a des variables. Vous pouvez utili- 
ser ces variables independamment de la chaine dont elles sont extraites a l'aide de la 
fonction sscanf ( ), dont la syntaxe est la suivante : 

array|string sscanf (string $ch, string "format" [, $varl,$var2,...]) 

Pour utiliser cette fonction, la chaine $ch doit repondre au format defini a l'aide des 
specificateurs recapitules au tableau 4-1, que vous avons deja rencontres avec la fonction 
pri ntf ( ). Elle peut alors etre bien analysee. Chacun de ces elements est affecte aux varia- 
bles dont les noms sont donnes dans les parametres $varl, $var2, etc. 

Dans l'exemple 4-6, la chaine $personne contient quatre informations ecrites selon le 
format precis suivant : 

"date_de_naissance-date_de_deces prenom nom" 

Dans l'exemple 4.7, la chaine de format qui permet d' analyser et de recuperer chacun de 
ses elements est la suivante (voir repere Q ) : 

| $format="%d-%d %s %s" 

La fonction sscanf () affecte ces informations aux variables nominees $ne, $mort, $prenom 
et $nom (repere ©) et retourne le nombre d' informations dans la variable $nb. Ces varia- 
bles sont utilisees pour un affichage (repere ©). 

Exemple 4-7. Capture de sous-chaines dans des variables 

<?php 

$personne = "1685-1750 Jean-Sebastien Bach"; 

$format="%d-%d %s %s";<-0 

$nb = sscanf ($personne,$format,$ne,$mort,$prenom t $nom) ; <— © 

echo "$prenom $nom ne en $ne, mort en $mort <br />";<—© 

echo "Nous lisons $nb informations";; 

?> 

Le resultat affiche est le suivant : 



Jean-Sebastien Bach ne en 1685, mort en 1750 
Nous lisons 4 informations 
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Comparaison de chaines 

Les operateurs de comparaison usuels sont utilisables avec les chaines. Cela inclut bien 
sur les operateurs d'egalite (==) et d'identite (===), ce dernier ne permettant d'obtenir la 
valeur TRUE dans une expression conditionnelle que si les deux operandes ont non seule- 
ment la meme valeur mais aussi le meme type. 

Avec l'operateur d'egalite, si les deux operandes sont des chaines, elles doivent avoir exac- 
tement les memes caracteres pour que l'egalite soit verifiee. Le code suivant affiche FALSE : 

$ch="scripts PHP 5"; 
$ch2="script PHP 5"; 
if($ch2==$ch) echo "TRUE <br />"; 
else echo "FALSE <br />"; 

Si la comparaison se fait entre une chaine commencant par des chiffres et un nombre, elle 
a lieu comme s'il s'agissait de deux nombres, seuls les caracteres numeriques du debut 
de la chaine etant pris en compte. Le code suivant affiche TRUE : 



$nb=59; 

$ch="59scripts" ; 
if($ch==$nb) echo 
else echo "FALSE < 



"TRUE <br />" 
br />"; 



Par contre, si vous ecrivez if ($ch===$nb), le script affiche FALSE car les types sont diffe- 
rents (integer et string). 

De meme, si vous utilisez les operateurs arithmetiques +, -, *, /, , et % entre une chaine et 
un nombre, vous obtenez un nombre si la chaine commence par des chiffres. Le code 
suivant affiche, par exemple, le nombre 531. II ne s'agit pas de la chaine "531" mais d'un 
entier, ce qui est verifiable en utilisant la fonction gettypeO : 

$nb=59; 

$ch="9scripts" ; 

echo $nb*$ch;//Affiche 531 soit 59 x 9 

echo gettype($nb*$ch) ;//Affiche integer 

Moins habituel, vous pouvez comparer des chaines alphabetiques entre elles ou avec des 
nombres au moyen des operateurs a priori reserves a des nombres. II s'agit des opera- 
teurs <, >, <= et >=. Si les operandes sont des chaines, la comparaison est effectuee en 
fonction de l'ordre ASCII des caracteres des chaines. Par exemple, le code suivant : 

$chl="Blanc"; 

$ch2="Bleu"; 

$ch3="blanc"; 

if($chl>$ch2) echo "TRUE <br />"; 

else echo "FALSE <br />"; //Affiche FALSE 

if($chl<$ch3) echo "TRUE <br />"; 

else echo "FALSE <br />"; //Affiche TRUE 

affiche d'abord FALSE pour la comparaison ($chl>$ch2) car les deux premiers caracteres 
sont identiques et que "a<e" est vrai dans l'ordre ASCII. II affiche ensuite TRUE pour la 
comparaison ($chl<$ch3) car les minuscules ont des codes inferieurs aux majuscules. 
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Pour comparer des chaines et obtenir leur ordre alphabetique, au sens ASCII du terme, 
vous disposez aussi des fonctions PHP suivantes : 

Iint strcmp (string $chl, string $ch2) 
int strcasecmp (string $chl, string $ch2) 

Leur fonctionnement est identique, mais la premiere fonction est sensible a la casse alors 
que la seconde ne Test pas. Elles retournent toutes deux un nombre negatif (generale- 
ment -1) si $chl est inferieure a $ch2, un nombre positif (generalement 1) dans le cas 
contraire et en cas d'egalite. 

Les fonctions strncmp( ) et strncasecmp( ) realisent respectivement les memes actions que 
strcmpO et strcasecmpO mais en limitant la comparaison aux N premiers caracteres. 
Leurs syntaxes sont les suivantes : 



I 

Le code suivant assure la meme comparaison que les operateurs vus precedemment : 



int strncmp(string $chl, string $ch2, int N) 

int strncasecmp ( string $chl, string $ch2, int N) 



$chl="Blanc"; 

$ch2="Bleu"; 

$ch3="blanc"; 

echo strcmp ($chl ,$ch2) ;//Affiche -1 

echo strcasecmp ($chl,$ch3) ;//Affiche 

echo strncasecmp ( $chl, $ch2,2) ;//Aff iche 

La methode de comparaison de ces fonctions etant fondee sur les codes des caracteres, 
elle donne des resultats qui peuvent paraitre etranges. Par exemple, le code suivant : 

I$ch4="page2"; 
$ch5="pagel2"; 
echo strcmp ( $ch4,$ch5) ;//Affiche 1 

affiche la valeur 1. "page2" est done considere superieur a "pagel2". Si vous souhaitez 
realiser un tri, cela n'est pas concevable. 

Pour pallier cet inconvenient, vous disposez des fonctions suivantes, qui effectuent une 
comparaison dans l'ordre « naturel », dans lequel "page2" est avant "pagel2" : 

Iint strnatemp (string $chl, string $ch2) 
int strnatcaseemp (string $chl, string $ch2) 

La premiere fonction est sensible a la casse mais pas la seconde. 

Le code suivant : 

$ch4="page2"; 

$ch5="pagel2"; 

echo strnatcmp($ch4,$ch5) ;//Affiche -1 

affiche une valeur negative, et vous avez done bien "page2" inferieur a "pagel2". 
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Dans des recherches de mots, il est possible d'obtenir le nombre de caracteres communs 
a deux chaines en utilisant la fonction suivante : 

int similar_text ( string $chl, string $ch2 [, $pourcent]) 

qui retourne ce nombre. Si le troisieme parametre est utilise, le pourcentage de similarite 
est retourne dans la variable $pourcent (le nom de la variable est ici arbitraire). Notez que 
la comparaison est sensible a la casse. 

Par exemple, le code suivant : 

$ch4="MySQL"; 

$ch5="PgSQL"; 

echo similar_text($ch4,$ch5,$pourc) , " caracteres communs"; 

echo "Similarite : " ,$pourc, "%" ; 

affiche le resultat suivant : 



3 caracteres communs 
Similarite : 60% 



Transformation de chaines en tableaux 

Vous avez la possibilite d'extraire chacun des « mots » d'une chaine et d'obtenir un 
tableau dont les elements contiennent chacun de ces mots. Vous devez pour cela utiliser 
la fonction suivante : 

array explode ( string sep, string $ch [, int N]) 

La fonction retourne un tableau des mots de $ch, le critere de separation etant donne par 
la chaine sep (souvent une espace). Si le dernier parametre est fourni, le tableau ne 
contient que N elements au maximum, le dernier element contenant toute la fin de la 
chaine initiale. 

La fonction impl ode( ) est la reciproque de expl ode( ). Elle retourne une chaine composee 
des elements d'un tableau separes par un caractere donne. Sa syntaxe est la suivante : 

string implode ( string sep, array $tab) 

L'exemple 4-8 illustre ces deux fonctions avec differents separateurs. 

; *~ Exemple 4-8. Passages reciproques de chaines en tableaux 

<?php 

//Passage chaine -> tableau 

$chl="L'avenir est a PHP5 et MySQL"; 

$tabl=explode(" ",$chl); 

echo $chl,"<br />" ; 

print_r($tabl) ; 

echo "<hr />"; 
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$ch2="C:\wampserver\www\php5\chaines\string2.php" 

$tab2=explode("\\",$ch2); 

echo $ch2,"<br />"; 

print_r($tab2); 

echo "<hr />"; 

//Passage tableau -> chaine 

$tab3[0]="Bonjour"; 

$tab3[l]="monsieur" ; 

$tab3[2]="Rasmus"; 

$tab3[3]="Merci!"; 

$ch3=implode(" \$tab3); 

echo $ch3,"<br />"; 

?> 

L'exemple retourne les resultats suivants : 



L'avenir est a PHP5 et MySQL 

Array ( [0] => L'avenir [1] => est [2] => a [3] => PHP5 [4] => et [5] => MySQL ) 

C:\wampserver\www\php5\chaines\string2.php 

Array ( [0] => C: [1] => wampserver [2] => www [3] => php5 [4] => chaines [5] => 

string2.php ) 

Bonjour monsieur Rasmus Merci ! 



Les expressions regulieres 

Une expression reguliere, ou regular expression, ou encore expression rationnelle, 
permet de definir un modele general, appele motif de l'expression reguliere, au moyen de 
caracteres particuliers, representatifs d'un ensemble de chaines de caracteres tres variees. 

Si vous definissez, par exemple, comme caracteristique d'un modele de mot que la 
premiere et la troisieme lettre d'un mot doivent etre un "p", quantite de mots d'un diction- 
naire francais repondent a ce critere, tels papa, pipe, pipeau, pipelette, etc. Ces motifs 
permettent de rechercher dans un texte s'il existe des occurrences d'un mot ou de retrou- 
ver tous les mots qui repondent a tel critere particulier, comme vous venez de le voir. 

lis peuvent aussi permettre de verifier si une saisie faite par un visiteur du site est 
conforme au format couramment attendu, comme celui d'une adresse e-mail, et, dans le 
cas contraire, d'afficher un message d'erreur. Sans ce type de verification, tout contact 
serait impossible entre un client qui se serait identifie avec une adresse contenant une 
erreur de format et un site commercial qui enregistre les adresses e-mail pour envoyer 
une confirmation de commande, par exemple. 

Vous allez voir successivement comment ecrire des motifs representatifs puis les diffe- 
rentes fonctions offertes par PHP pour operer des verifications sur des chaines de 
caracteres. Dans la pratique, ces chaines proviennent le plus souvent de saisies effectuees 
dans un formulaire. 
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Definition d'un motif elementaire 



L'ecriture des motifs d'expressions regulieres est la partie la plus rebarbative du travail 
de codage. Un grand soin est requis dans leurs ecritures car cela conditionne la qualite du 
resultat. Les motifs sont toujours contenus dans des chaines de caracteres, et done entre 
guillemets. 

Recherche de un ou plusieurs caracteres 

Pour rechercher la presence d'un caractere particulier, il suffit de l'inclure entre des 
guillemets simples ou doubles. Pour rechercher le caractere @, vous ecrivez le modele : 

$modele="@" ; 

Pour verifier si une chaine contient un au moins des caracteres d'une liste, vous enumerez 
tous ces caracteres entre crochets. 

Pour rechercher un ou plusieurs des caracteres xyz, vous avez done le motif suivant : 

$modele="[xyz]" ; 



Caractere et caracteres 

La presence d'un seul des caracteres de la liste dans la chaine sur laquelle s'effectue la recherche fournit 
un resultat positif. La presence d'autres caracteres quelconques est done possible. En d'autres termes, la 
presence d'au moins un des caracteres definis dans le motif ne signifie pas qu'il n'y en a pas d'autres non 
contenus dans le motif. 



Avec la meme syntaxe, vous pouvez definir comme motif un intervalle de lettres ou de 
chiffres. 

Par exemple, si vous ecrivez : 

Smodele = "[a-z]"; 

vous recherchez un mot d'au moins un caractere contenant n'importe quelles lettres 
minuscules. 

De meme, le motif suivant : 

Smodele = "[A-Z]"; 
recherche n'importe quel groupe de majuscules. 
Le suivant : 

Smodele = "[0-9]"; 
recherche la presence d'au moins un chiffre entre et 9. 



Echappement des caracteres speciaux 

Pour rechercher dans une chaine les caracteres qu 
echapper en les faisant preceder d'un antislash (\). 
(, ), + et*. 


ont 

Cela 


une signification particuliere, 
s'applique aux caracteres ., 


vous 


devez les 
?, \, [, ], 
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II existe des classes de caracteres predefinies, qui evitent d' avoir a creer vous-meme les 
ensembles de caracteres recherches. Ces classes sont recapitulees au tableau 4.2. 

Tableau 4-2 - Les classes de caracteres predefinies 



Classe 

[[ :alnum:] 

[[ : alpha : ] 

[[:blank:] 

[[:ctrl:] 

[[:digit:] 

[[:print:] 

[[:punct:] 

[[:space:] 

[[:upper:] 

[[ :xdigit: 



Definition de la recherche 

Tous les caracteres alphanumeriques. Equivalent de I'ensemble [a-zA-ZO-9] 

Tous les caracteres alphabetiques. Equivalent de I'ensemble [a-zA-Z] 

Tous les caracteres blancs (espaces, tabulations, etc.) 

Tous les caracteres de controle 

Tous les chiffres. Equivalent de I'ensemble [0-9] 

Tous les caracteres imprimables, non compris les caracteres de controle 

Tous les caracteres de ponctuation 

Tous les caracteres d'espace (espace, tabulation, saut de ligne) 

Tous les caracteres en majuscules 

Tous les caracteres en hexadecimal 



Les classes du tableau sont utilisables comme les autres motifs en les ecrivant dans une 
chaine de caracteres delimitee par des guillemets. 

Vous ecrivez, par exemple, le modele suivant : 

$modele="[[: alpha:]]" ; 
pour rechercher des caracteres alphabetiques en minuscule ou en majuscule. 
Le modele suivant : 

$modele="[[:digit:]]" ; 
vous permet de rechercher la presence de chiffres. 

Recherche d'une chaine precise 

Pour rechercher la presence d' un mot precis dans une chaine, creez le motif en ecrivant le 
mot entre guillemets. La recherche est validee si le mot se trouve exactement dans la 
chaine analysee et en respectant la casse. 

Le motif suivant : 

$modele = "Paris" ; 

verifie si le mot Paris est present dans la chaine analysee. La chaine Visite a Paris est 
done conforme au modele mais pas la chaine Vi site a pan's. 

Pour detecter la presence d'au moins une chaine parmi deux, vous devez utiliser l'opera- 
teur logique OU, symbolise par le caractere pipe ( | ) place entre les mots a rechercher. 
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Le motif suivant : 

$modele="\.com| \.net" ; 

recherche des chaines .com ou .net. L'adresse www.php.net est done validee mais pas 

www.w3c.org. 

Restriction de caracteres 

Pour interdire la presence d'un groupe de caracteres, faites-le preceder par le caractere A . 
Pour exclure une plage entiere de caracteres, incluez le caractere A devant les caracteres 
entre crochets qui definissent l'ensemble des caracteres ou la plage de caracteres. 

Prenez garde a cette definition car la presence d'un seul caractere different de ceux qui 
sont exclus rend la verification valide, meme si ce caractere est precede ou suivi de carac- 
teres interdits. 

Par exemple, le motif suivant : 

| $modele="[ A abc]"; 

exclut les caracteres a be. La chaine caba ne repond done pas a cette definition alors que la 
chaine cabas est conforme au modele par le seul ajout du caractere s. 

De meme, le motif suivant : 

| $modele="[ A A-Z]"; 

exclut les chaines composees uniquement de lettres majuscules. Par exemple, la chaine 
PHP est exclue mais pas PHP 5. 

Le motif : 

$modele="[ A 0-9]"; 

exclut les chaines composees uniquement de chiffres. Par exemple, la chaine 2005, qui ne 
comporte que des chiffres, est exclue mais pas la chaine 02-03-2005, qui comporte un 
autre caractere. 

Ce meme caractere A peut avoir une autre signification s'il est place devant un caractere 
ou une classe de caracteres mais pas entre crochets. Dans ce cas, la chaine sur laquelle est 
effectuee la recherche doit commencer par les caracteres qui suivent. 

Par exemple, le motif suivant : 

$modele= " A bon"; 

permet de rechercher si une chaine commence par les lettres bon, comme bonjour Max ou 
bonne blague. 

Pour imposer qu'une chaine se termine pas un ou plusieurs caracteres determines, faites 
suivre ces derniers du caractere $. 

Pour imposer, par exemple, qu'une adresse e-mail se termine par .com, ecrivez le motif 
suivant : 

$modele= "\.com$"; 



PHP 5 



Creation de modeles generaux 

L'utilisation de caracteres speciaux permet de creer des modeles, dans lesquels vous 
pouvez preciser si un caractere doit etre present zero, une ou plusieurs fois de suite. 

Le caractere point ( . ) permet de rechercher n'importe quel caractere. L'exemple suivant : 

$modele= "mat." 

cree le modele permettant de rechercher tous les mots contenant le mot mat suivi d'au 
moins un caractere. Vous obtenez aussi bien mate, math que materiel mais pas la chaine 
echec et mat, car mat n'est suivi d'aucun caractere. 

Le caractere ? indique que le caractere qui precede doit etre present zero ou une fois. 
Le caractere recherche peut etre present plusieurs fois sans pour autant invalider la 
recherche. 

L'exemple suivant : 

$modele= "math?" 

cree le modele permettant de chercher la presence des lettres mat suivies ou non de la 
lettre h dans une chaine quelconque. Vous pouvez obtenir math, mathematiques, matrice, 
mais aussi mathh, car il peut exister d'autres caracteres identiques apres le motif defini. 

Le caractere + indique que le caractere qui precede doit etre present au moins une fois 
dans la chaine analysee. 

L'exemple suivant : 

$modele= "nat+" 

recherche si une chaine contient les lettres na suivies de une ou de plusieurs lettres t. 
Vous obtenez, par exemple, nat, nathalie, natte, naturel, mais pas naval. 

Le caractere * indique que le caractere qui precede doit etre present zero ou plusieurs fois 
dans la chaine sur laquelle s'effectue la recherche. 

Le motif suivant : 

$modele= "pour*" ; 

recherche les lettres pou suivies de la lettre r presente un nombre quelconque de fois puis, 
eventuellement, d'une suite de caracteres quelconque. Vous pouvez obtenir les mots pou, 
poulette, pourri, etc. 

En associant les caracteres . et *, vous pouvez rechercher une suite quelconque de carac- 
teres, le point specifiant n'importe quel caractere et l'etoile zero a ,/V occurrences d'un 
meme caractere. 

Le motif suivant : 

$modele= "mat.*" ; 

recherche tous les mots d'un nombre de caracteres quelconque contenant les lettres mat. 
Vous trouvez, par exemple, mat, math, materiel ou matter. 



Les chaines de caracteres 

Chapitre 4 

L'usage des parentheses associees aux caracteres precedents effectue des regroupements 
permettant des recherches plus precises. 

Le motif suivant : 

$modele= "(ma)+" ; 

recherche la presence du groupe de caracteres ma au moins une fois. 

Recherche d'un nombre donne de caracteres 

L'usage des accolades permet de preciser le nombre de fois que vous souhaitez voir 
apparaitre un caractere ou un groupe de caracteres, selon les definitions suivantes : 

• { n } cherche exactement n fois le caractere ou le groupe qui precede. 

• {n , } cherche au minimum n fois le caractere ou le groupe qui precede. 

• {n ,m} cherche entre n et m fois le caractere ou le groupe qui precede. 
Par exemple, le motif suivant : 

$modele= "cor{2}" ; 

recherche des mots contenant les caracteres corr. 

Ici encore, le modele recherche peut etre suivi d'autres caracteres, y compris celui sur 
lequel s'appliquent les accolades. Les chaines correcteur, corrige mais aussi corrr sont 
done valides. En revanche, corsage ne Test pas. 

Le motif suivant : 

$modele= "cor{l,l" ; 

recherche dans une chaine la presence des lettres co, suivies d'un nombre quelconque de 
caracteres r. Les chaines cor, corr, corrr, etc., sont done valides. 

Les fonctions de recherche PHP 

Comme explique precedemment, plusieurs extensions PHP permettent d'utiliser des 
expressions regulieres et done plusieurs series de fonctions utilisables dans ce but. 

Nous nous penchons ici sur les fonctions standards de PHP. 

Les fonctions elementaires de recherche de PHP sont les suivantes : 

Ibool ereg ( string Smodele, string $ch [, array $tab]) 
bool eregi ( string $modele, string $ch [, array $tab]) 

Elles permettent de controler la presence d'une sous-chaine repondant au motif d'expres- 
sion reguliere $model e dans $ch. Le troisieme parametre est un tableau indice qui contient 
la chaine $ch dans l'element d'indice ainsi que les sous-chaines repondant au modele 
dans les elements suivants. Elles retournent TRUE si le motif est trouve et FALSE dans le cas 
contraire. La seule difference entre ces deux fonctions est que eregO est sensible a la 
casse alors que eregi ( ) ne Test pas. 



PHP 5 



L'exemple 4-9 constitue votre premiere application pratique. La definition du motif 
(repere Q) exige la presence de quatre chiffres (code ([[:digit:]]{4})), suivis d'un 
nombre quelconque de caracteres (code ( .*)). L'utilisation de la fonction eregO permet 
de valider ce motif (repere ©). Si la chaine $ch contient le motif, un message est affiche 
(repere ©). L'utilisation du tableau $tab permet ensuite de recuperer et d'afficher la date 
(repere ©) et l'evenement (repere ©). Dans le cas contraire un message indique la non- 
conform! te du motif recherche (repere ©). 

Exemple 4-9. Recherche dans une chaine 

<?php 

$ch="1789 Prise de la Bastille"; 

$modele= "( [[:digit:]]{4} )( .*) <-© 

if(ereg($modele,$ch,$tab)) <— Q 

{ 

echo "La chaine \"$ch\" est conforme au modele \"$modele\" <br />";<—© 

echo "Date : " ,$tab[l] , "<br />";<-© 

echo "Evenement : " ,$tab[2] , "<br />";<—© 
} 

else echo "La chaine \"$ch\" n'est pas conforme au modele \"$modele\" " ; <— © 
?> 

L'exemple affiche le resultat suivant : 



La chaine "1789 Prise de 

Date : 1789 

Evenement : Prise de la Basti 



Bastille" est conforme au modele "( [[ :digit: ]]{4} )( .*)" 



Les fonctions suivantes permettent de realiser des operations de remplacement d'une 
sous-chaine conforme a un motif defini par une autre chaine. Elles retournent une chaine 
modifiee, mais la chaine initiale $ch reste intacte (a nouveau, la seule difference entre les 
deux fonctions est que eregi_repl ace( ) est insensible a la casse) : 

I string ereg_replace ( string Smodele, string $remp, string $ch) 
string eregi_replace ( string Smodele, string $remp, string $ch) 

L'exemple 4-10 utilise ces fonctions. La premiere remplace un chiffre defini par le 
motif [ [ : di gi t : ] ] par le chiffre 5 (repere ©). Toutes les occurrences de ce chiffre sont 
remplacees. La deuxieme remplace un mot par un autre (repere ©) ou le caractere de 
saut de ligne \n par l'element XHTML <br /> (repere ©). La suivante effectue deux 
remplacements successifs dans la me me chaine (reperes © et ©). La derniere montre 
que la chaine de remplacement peut etre definie par une fonction a condition qu'elle 
retourne une valeur de type string. Ici, n'importe quel groupe de quatre chiffres defini par 
le motif [0-9] {4} (typiquement une annee) est remplace par la chaine 2004 (repere ©). 

Exemple 4-10. Remplacement de sous-chaTnes 

|<?php 
$ch = "La 4e \n version est PHP 4:\n Viva PHP4"; 
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h2=ereg_repl ace ( " [ [ : di gi t : ] ] " , 
ho $ch2,"<br />"; 
ho ereg_replace (" est", " fut" 
ho ereg_replace ("\n", "<br />" 
ho $ch,"<br />";; 



"5", $ch); <-0 

$ch),"<br />" ; <-© 
$ch2),"<br />"; <-© 



h = "Quatre mariages et un enterrement "; 
h2=eregi_replace ("MARIAGE", "divorce", $ch);<— Q 
h2=ereg_repl ace ("enterrement", "manage", $ch2);<— Q 
ho $ch2,"<br />"; 



h = "Nous sommes en 2003 " 
ho ereg_replace ( "[0-9] {4} 



dateC'Y"), $ch); <-0 



L'exemple affiche le resultat suivant 



La 5e version est PHP 5: Viva PHP5 

La 4e version fut PHP 4: Viva PHP4 

La 5e 

version est PHP 5: 

Viva PHP5 

La 4e version est PHP 4: Viva PHP4 

Quatre divorces et un mariage 

Nous sommes en 2004 



Definition d'un motif complexe 

Vous allez maintenant aborder la maniere de creer des modeles complexes afin de reali- 
ser des recherches ou des validations d'expressions complexes, comme des montants 
financiers ou des adresses e-mail. 

Elle consiste a combiner les differentes possibilites que vous avez decouvertes a la 
section precedente. 

Validation d'un nom 

En prenant pour hypothese qu'un nom de famille est compose uniquement de lettres et 
des caracteres apostrophes (') et tiret (-) pour les prenoms composes, a l'exclusion de 
tout autre, vous creez le modele suivant : 

$modele=" A ([a-zA-Z])([- a-zA-Z]*)$"; 

II ne recherche que les noms commencant par des lettres suivies eventuellement d'un 
tiret, d'une espace et de lettres, ces caracteres devant constituer la fin du nom. Les chiffres 
et les autres caracteres sont exclus. 



L'exemple 4-11 affiche un message si le nom ne correspond pas a ces criteres. 
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Exemple 4-1 1 . Validation d'un nom complet 

<?php 

$modele=" A ([a-zA-Z])([- a-zA-Z]*)$"; 

$nom="Jean-Paul DEUX"; 

if ( leregi ($modele,$nom)) 

{echo "Le nom \"$nom\" n'est pas conforme. Veuillez le ressaisir! " ; } 

?> 

Le nom Jean-Paul Deux est accepts, mais pas Jean-Paul 2. Ce script peut etre utilise pour 
verifier les saisies effectuees dans un formulaire avant l'enregistrement des donnees. 

Valider une adresse e-mail 

Vous cherchez maintenant a valider une adresse e-mail saisie par un utilisateur. 
Les adresses valides sont de la forme : 

Inom@domaine.uk 
prenom.nom@domaine.com 
prenom-nom@domaine.info 

Les extensions des domaines sont limitees a quatre caracteres. 

Le modele suivant est beaucoup plus complexe que les precedents : 

$modele="( A [a-z])([a-zO-9])+(\.|-)?([a-zO-9]+)@([a-zO-9]+)\.([a-z] {2,4}$)"; 

II oblige 1' adresse a commencer par des lettres (partie ( A [a-z])), suivies de un ou 
plusieurs caracteres alphanumeriques (partie ([a-z0-9])+) puis d'un point ou d'un tiret 
optionnels (partie (\. | -)?)). Le groupe de caracteres suivant peut etre alphanumerique 
(partie ( [a-z0-9]+)). La presence du caractere @ est obligatoire. II doit etre suivi d'au moins 
deux caracteres alphanumeriques representant le nom de domaine (partie ( [a-zO-9] {2 , } )). 
La presence d'un point puis d'une extension alphabetique de deux a quatre lettres doit 
terminer 1' adresse (partie \.([a-z]{2,4}$)) pour etre valide. 

Le script de 1' exemple 4-12 utilise ce motif pour creer une fonction de validation 
(repere Q). Le parametre unique $ch represente l'adresse a verifier. L' adresse est d'abord 
convertie en minuscules (repere©), puis la fonction eregO verifie la conformite de 
l'adresse au motif (repere ©). Selon le cas, la fonction affiche le message adequat et 
retourne TRUE ou FALSE. 

Exemple 4-12. Validation d'une adresse e-mail 

<?php 

//Creation de la fonction de validation 

function val idmail ($ch) <— O 

{ 

$modele="(*[a-z])([a-z0-9])+(\.|-)?([a-z0-9]+)@([a-z0-9]{2,})\.([a-z]{2,4}$)"; 

$ch=strtolower($ch); <-© 

if (ereg($modele, $ch))<— Q 

{ 
echo "$ch est valide <br />"; 
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return TRUE; 



echo "$ch est invalide <br />"; 

return FALSE; 
} 
} 

//Utilisation de la fonction de validation 
$mail=" Jean5.dupont@laposte2.uk" ; 
$mail2="5pierre.dupapi@plusloin.info" ; 
$mai'13="engel s-jean@funphp.com" ; 
validmail ($mail ) ; 
val idmail ($mail2) ; 
val idmail ($mail3) ; 
?> 

Le resultat affiche est le suivant : 



jean5.dupont@laposte2.net est valide 
5pierre.dupap@pl usloin.info est invalide 



Memo des fonctions 

string addslashes(string str) 

Ajoute des antislashs dans une chaine. 

string chunk_spl it(string $ch , int N , string $ f i n ) 

Scinde une chaine en introduisant la chaine $f i n tous les N caracteres. 

string crypttstring $ch [, string $sel]) 

Crypte la chaine $ch a I'aide de $sel . 

void echo string $chl string $chN 

Affiche une ou plusieurs chaines de caracteres. 

array explode(string $sep , string $ch [, int N]) 

Transforme une chaine en tableau indice d'au maximum N elements en utilisant le caractere $sep comme critere de coupure. 

string html_entity_decode( string $ch , int CTE[, string charset]]) 

Convertit toutes les entites XHTML en caracteres normaux. 

string htmlentitieststring string , int quote_style , string charset) 

Convertit tous les caracteres en entites XHTML. 

string html special chars(string string , int quote_style , string charset) 

Convertit les caracteres speciaux en entites XHTML. 

string implode(string $sep , array $tab) 

Reunit tous les elements d'un tableau dans une chaine en les separant par le caractere $sep. 
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string ltrimtstring $ch [, string $1 i ste] ) 

Supprime tous les caracteres d'espace en debut de chaine ou seulement ceux qui sont listes dans $1 i ste. 

string nl2br(string $ch) 

Remplace les sauts de ligne \n par I'element XHTML <br />. 

int ord(string $ch) 

Retourne le code ASCII du caractere $ch. 

int printtstring $ch) 

Affiche une chaine de caracteres. 

void printf (string "format" , string $chl , . . .$chN) 

Affiche des chaines de caracteres formatees a I'aide de caracteres speciaux. 

string quotemetatstring $ch) 

Echappe les caracteres . , \, +,*,?,[,],(,),$ et \ 

string rtrim(string $ch [, string $liste]) 

Supprime tous les caracteres d'espace en fin de chaine ou seulement ceux qui sont listes dans $1 i ste. 

int similar_text(string $chl , string $ch2 [, $pourcent]) 

Calcule la similarity de deux chaines en nombre de caracteres ou en pourcentage retourne dans la variable $pourcent. 

string sprintf (string "format" , string $chl, string $ch2,... $chN) 

Retourne une chaine formatee contenant les variables $chl a $chN. 

divers sscanf (string $ch , string "format" [, string $chl $chN]) 

Decompose une chaine selon un format donne et retourne ses elements dans un tableau ou dans les variables $chl 
a$chN. 

mixed str_i repl ace(mixed search , mixed replace , mixed subject , int &count) 

Version insensible a la casse de str_replace( ). 

string str_pad(string input , int pad_length , string pad_string , int pad_type) 

Complete une chaine jusqu'a une taille donnee. 

string str_repeat(string input , int multiplier) 

Repete une chaine. 

mixed str_replace(string $chl, string $ch2, string $ch [.string $var]) 

Remplace toutes les occurrences de $chl par $ch2 dans une chaine $ch. Le nombre de remplacement est contenu 
dans $var. 

string str_shuffle(string $ch) 

Melange aleatoirement les caracteres d'une chaine de $ch. 

array str_spl ittstring $ch [, int N]) 

Convertit une chaine de caracteres en tableau dont chaque element a N caracteres (1 par defaut). 

mixed str_word_count(string $ch) 

Retourne le nombre de mots presents dans une chaine. 
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int strcasecmp(string $chl , string $ch2) 

Compare les chaines $chl et $ch2 (sensible a la casse). 

string strip_tags(string $ch [, string $liste]) 

Supprime les balises XHTML et PHP d'une chaine, sauf celles qui sont contenues dans la chaine $1 iste. 

int stripoststring haystack , string needle , int offset) 

Version insensible a la casse de strpos( ). 

string stripsl asheststring $ch) 

Supprime les antislashs d'une chaine et retourne la chaine nettoyee. 

string stristrtstring $ch , string $ch2) 

Version insensible a la casse de strstrt ). 

int strlentstring $ch) 

Retourne la taille d'une chaine. 

int strnatcasecmp(string $ch, string $ch2) 

Comparaison de chaines avec I'algorithme d'ordre naturel mais insensible a la casse. 

int strnatcmp(string strl , string str2) 

Comparaison de chaines avec I'algorithme d'ordre naturel. 

int strncasecmptstring $ch, string $ch2, int N) 

Compare en binaire des chaines de caracteres. 

int strncmptstring $ch, string $ch2, int N) 

Compare en binaire les n premiers caracteres. 

array strpbrk(string $ch, string $ch2) 

Recherche une chaine de caracteres dans un ensemble de caracteres. 

int strpoststring $ch, string $ch, int offset) 

Trouve la position d'un caractere dans une chaine. 

string strrchr(string $ch, char needle) 

Trouve la derniere occurrence d'un caractere dans une chaine. 

string strrev(string $ch) 

Inverse une chaine. 

int strripos(string $ch, string $ch, int offset) 

Trouve la position de la derniere occurrence d'une chaine dans une autre de fagon insensible a la casse. 

int strrpoststring $ch, string $ch, int offset) 

Trouve la position de la derniere occurrence d'un caractere dans une chaine. 

int strspntstring $ch, string $ch2, int start , int length) 

Trouve le premier segment d'une chaine. 
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string strstr(string Sch, string $ch2) 

Recherche la premiere occurrence dans une chaine $ch2 dans $ch et retourne tous les caracteres de $ch2 compris a la 
fin de la chaine $ch. 

string strtolower(string $ch) 

Retourne $ch en minuscules. 

string strtoupper(string $ch) 

Retourne $ch en majuscules. 

string strtrtstring $ch, string $listel , string liste2) 

Remplace les caracteres de $1 i stel par ceux de $1 i ste2 dans une chaine $ch. 

int substr_count(string $ch, string $ch) 

Retourne le nombre d'occurrences de $ch2 dans la chaine $ch. 

string substr(string $ch, int ind , int N) 

Retourne la chaine contenant N caracteres de $ch extraits a partir de I'indice i nd. Si le parametre W est omis, retourne 
la sous-chaine comprise entre I'indice ind et la fin de $ch. 

string trimtstring $ch [, string liste]) 

Supprimetous les caracteres d'espace en debut et en fin de chaine ou seulement ceux qui sont listes dans $liste. 

string ucfi rst(string $ch) 

Retourne $ch avec le premier caractere en majuscule. 

string ucwords(string $ch) 

Retourne $ch avec le premier caractere de chaque mot en majuscule. 

void vprintf (string "format" , array $tab) 

Affiche une chaine formatee composee des elements du tableau Stab. 

string vsprintf (string format , array Stab) 

Retourne une chaine formatee composee des elements du tableau Stab. 

string wordwraptstring Sch [, int N [, string car [. boolean coupe]]]) 

Realise la cesure de Sch tous les N caracteres. car contient la chaine a inserer dans Sch tous les N caracteres. Le para- 
metre booleen coupe, s'il vaut TRUE, permet d'effectuer une cesure des mots dont la longueur depasse N caracteres. 



Exercices 



Exercice 1 

Transformez une chaine ecrite dans des casses differentes afin que chaque mot ait une 
initiale en majuscule. 

Exercice 2 

En utilisant la fonction strl en( ), ecrivez une boucle qui affiche chaque lettre de la chaine 
PHP 5 sur une ligne differente. 
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Exercice 3 

Formatez l'affichage d'une suite de chaines contenant des noms et prenoms en respectant 
les criteres suivants : un prenom et un nom par ligne affiches sur 20 caracteres ; toutes les 
initiales des mots doivent se superposer verticalement. 

Exercice 4 

Utilisez les fonctions adequates afin que la chaine <form action="script.php"> soit affi- 
chee telle quelle et non comme du code XHTML. 

Exercice 5 

A partir de deux chaines quelconques contenues dans des variables, effectuez une 
comparaison entre elles pour pouvoir les afficher en ordre alphabetique naturel. 

Exercice 6 

Effectuez une censure sur des textes en n'affichant pas ceux qui contiennent le mot zut. 

Exercice 7 

Creez une fonction de validation d'une adresse HTTP ou FTP en vous inspirant de 
l'exemple 4-13. 

Exercice 8 

Creez une expression reguliere pour valider un age inferieur a 100 ans. 

Exercice 9 

Dans la chaine PHP 5 \n est meilleur \n que ASP \n et JSP \n reunis, remplacez les 
caracteres \n par <br /> en utilisant deux methodes differentes (une fonction ou une 
expression reguliere). 
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Les tableaux 



Comme explique au chapitre 3, consacre aux types de donnees accessibles dans PHP, les 
tableaux representes par le type array sont d'une utilisation courante dans les scripts. La 
possibilite de stacker un grand nombre de valeurs sous un seul nom de variable offre 
des avantages appreciables, notamment une grande souplesse dans la manipulation des 
donnees. Les nombreuses fonctions natives de PHP applicables aux tableaux permettent 
les operations les plus diverses dans la gestion des tableaux. 

Dans ce chapitre, vous verrez : 

• les differentes facons de creer des tableaux ; 

• les methodes de lecture des elements de tableau ; 

• les fonctions de manipulation des tableaux. 

Creer des tableaux 
La fonction arrayf) 

La fonction array( ) permet de creer de maniere rapide des tableaux indices ou associa- 
tifs. C'est elle qui sera le plus souvent utilisee pour la creation de tableaux. 

Les tableaux indices 

La facon la plus elementaire de creer un tableau indice consiste a definir individuelle- 
ment une valeur pour chacun des ses elements, et ce de la maniere suivante : 

$tab[n] = valeur; 
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oil n est un indice entier quelconque, et val eur un scalaire ou une variable de type i nteger, 
double, boolean, string ou array. 

Cette maniere de proceder se revele rapidement rebarbative des qu'il s'agit de definir un 
nombre plus important d' elements. Pour creer un tableau compose de plusieurs elements 
en une seule operation, vous disposez heureusement de la fonction array (), dont la 
syntaxe est la suivante : 

$tab = array(valeurO,valeurl,...,valeurN) 

La variable $tab est ici un tableau indice dont les valeurs d'indice varient de a N. Ce 
tableau a done N + 1 elements, accessibles par la notation habituelle $tab[0], $tab[l], . . ., 
$tab[N], dont les valeurs respectives peuvent avoir l'un quelconque des types precites. 



Premier indice 

Avec ce mode de creation de tableau, le premier indice a, une fois encore, toujours la valeur . II ne faut 
pas oublier d'en tenir compte lors des operations de lecture des elements. 



Les tableaux associatifs 

La meme fonction array( ) permet aussi de creer rapidement un tableau associatif en defi- 
nissant pour chacun de ses elements une cle et une valeur. 

La syntaxe de la fonction array( ) est la suivante : 

$tabasso = array( "cleA"=>valeurA, "cleB"=>valeurB,... "cleZ"=>valeurZ) 

Comme vous l'avez vu au chapitre 2, chaque cle est une chaine de caracteres delimitee 
par des guillemets. 

Pour lire val eurA, vous ecrivez : 

$tabasso["cleA"] 

de la meme facon que lorsque chaque element est cree individuellement. 

Dans un tableau associatif, la notion d'ordre des elements perd la valeur qu'elle peut 
avoir dans un tableau indice. Les cles ne sont pas numerotees, par exemple. Vous pourriez 
enumerer cles et valeurs dans un ordre different sans que cela gene la lecture individuelle 
de chaque element. 

Vous auriez done pu creer le meme tableau en ecrivant : 

$tabasso = array( "cleZ"=>valeurZ, "cleY"=>valeurY,... "cleA"=>valeurA) 

qui correspond a l'ordre inverse. Vous pouvez en fait effectuer la creation dans un ordre 
quelconque, sans changer quoi que ce soit a l'acces aux valeurs a l'aide de leur cle. Cela 
confirme la souplesse d'utilisation des tableaux associatifs en comparaison des tableaux 
indices. Cette souplesse se revele particulierement utile dans les operations de suppres- 
sion d'elements ou de tri sur des tableaux, lesquelles peuvent faire perdre les associations 
entre indices et valeurs. 
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Les tableaux multidimensionnels 

Contrairement aux langages dans lesquels vous declarez les variables et leur type, 
comme ASP.Net utilise avec C#, PHP ne comporte pas de methode explicite de creation 
de tableaux multidimensionnels. C'est tout l'avantage de ce langage que d'autoriser 
qu'un element de tableau puisse etre un tableau lui-meme. La creation de tableau 
comportant un nombre quelconque de dimension en est d'autant facilitee. 

Un tableau multidimensionnel est similaire a une matrice, au sens mathematique du 
terme. La structure d'un tableau a deux dimensions peut se representer sous la forme 
d'un tableau a double entree, comme l'exprime le listing de l'exemple 5-1, dont le resul- 
tat est illustre a la figure 5-1. 
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Tableau multidimensionnel 



.. ligne 0-colonne .. 


.. ligne 0-colonne 1 .. 


.. tigne 0-colonne 2 .. 


.. ligne 1-colonne 0.. 


.. ligne 1-colonne 1 .. 


..ligne 1-colonne 2.. 


.. ligne 2-colonne .. 


.. ligne 2-colonne 1 _ 


.. ligne 2-colonne 2 .. 


.. ligne 3-colonne .. 


.. ligne 3-colonne 1 .. 


.. ligne 3-colonne 2 .. 



Figure 5-1 

Visualisation d'un tableau multidimensionnel 

Les valeurs des elements ont ete choisies de maniere a montrer clairement par la suite 
comment acceder a une valeur particuliere. Le premier chiffre est celui de la ligne, et le 
second celui de la colonne. Chaque ligne est a la fois un element du tableau principal, qui 
contient quatre elements, et est elle-meme un tableau a trois elements. 

Vous obtenez au total douze valeurs dans le tableau, mais il n'a que quatre elements. 

De meme que pour reperer un element dans un espace a n dimensions il faut utiliser N 
coordonnees, pour lire une valeur dans un tableau a n dimensions, il faut utiliser Af indi- 
ces, ou cles, differents. 

Par exemple, pour recuperer dans la variable $a la deuxieme valeur (indice 1) de la troi- 
sieme ligne (indice 2) du tableau precedent $tabmulti, ecrivez : 



$a = $tabmulti[2][l] 
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Dans cet exemple, chaque element du tableau est un tableau ayant autant d'elements 
que les autres, ce qui realise une matrice rectangulaire 4 x 3. II est evidemment possi- 
ble de creer des tableaux multidimensionnels non symetriques, dans lesquels le 
premier element pourrait etre, par exemple, une valeur entiere ou une chaine de carac- 
teres, le deuxieme element un tableau a dix elements, le troisieme un tableau avec un 
nombre d'elements differents puis tout autre combinaison possible. Quoique parfaite- 
ment realisable, ce type de tableau, qui est irregulier, risque de se reveler difficile a lire 
avec une boucle, comme vous le verrez dans les exemples presentes dans la suite du 
chapitre. 



Pour en savoir plus 

Les boucles sont abordees en detail au chapitre 3. 



Le listing 5-1 utilise deux boucles de lecture pour afficher le contenu du tableau. Vous 
pouvez tres bien envisager de creer de la meme facon des tableaux a trois, quatre dimen- 
sions et bien plus encore, mais la visualisation en devient vite difficile. 

Pour creer le tableau de la figure 5-1, utilisez la fonction array( ) de la facon suivante : 

$tabmul ti=array( 

arrayC'ligne 0-colonne 0","ligne 0-colonne l","ligne 0-colonne 2"), 

arrayC'ligne 1-colonne O'V'ligne 1-colonne l'V'ligne 1-colonne 2"), 

arrayC'ligne 2-colonne 0","ligne 2-colonne l","ligne 2-colonne 2"), 

array( "1 igne 3-colonne 0","ligne 3-colonne l","ligne 3-colonne 2") 

); 

Afin de visualiser la structure complete du tableau Itabmulti , vous pouvez, dans les 
phases de test des scripts, utiliser la fonction print_r($tabmulti ), qui affiche la structure 
suivante : 

Array ( 

[0] => Array ( [0] => 1 igne 0-colonne [1] => ligne 0-colonne 1 [2] => ligne 0-colonne 

2 ) 

[1] => Array ( [0] => ligne 1-colonne [1] => ligne 1-colonne 1 [2] => ligne 1-colonne 
2 ) 

[2] => Array ( [0] => ligne 2-colonne [1] => ligne 2-colonne 1 [2] => ligne 2-colonne 
2 ) 

[3] => Array ( [0] => ligne 3-colonne [1] => ligne 3-colonne 1 [2] => ligne 3-colonne 
2 ) ) 



Vous retrouvez bien les differents elements du tableau et leur contenu. 

La fonction var_dump($tabrnulti ) permet d'afficher un ensemble d' informations encore 
plus completes sur le tableau. Elle donne le nombre d'elements et la description de 
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chacun d'eux, ainsi que le type et le contenu de chaque valeur. Vous obtenez ainsi pour le 
meme tableau : 

array(4) ( [0]=> array(3) { [0]=> string(17) "ligne 0-colonne 0" [1]=> string(17) 

"ligne 0-colonne 1" [2]=> string(17) "ligne 0-colonne 2" } 

[1]=> array(3) { [0]=> string(17) "ligne 1-colonne 0" [1]=> stn'ng(17) "ligne 1-colonne 1" 

[2]=> string(17) "ligne 1-colonne 2" } 

[2]=> array(3) { [0]=> string(17) "ligne 2-colonne 0" [1]=> string(17) "ligne 2-colonne 1" 

[2]=> string(17) "ligne 2-colonne 2" } 

[3]=> array(3) { [0]=> string(17) "ligne 3-colonne 0" [1]=> string(17) "ligne 3-colonne 1" 

[2]=> string(17) "ligne 3-colonne 2" } } 

Dans cette description, array (4) signifie que la variable Stabmulti est un tableau a quatre 
elements. Vient ensuite la description de tous les elements sur le meme principe. Les 
expressions du type : 

[0]=> array(3) 

signifient que le premier element du tableau est lui-meme un tableau a trois elements. 
Les accolades qui suivent donnent le type et la valeur de chacun des elements de ce 
dernier tableau. Dans la suite de la description, nous trouvons : 

[0]=> string(17) "ligne 0-colonne 0" 

qui indique que l'element d'indice est une chaine de dix-sept caracteres, dont la valeur 

est "ligne 0-colonne 0". 

L'utilisation de ces fonctions sert au programmeur a des fins de debogage des scripts. II 
serait maladroit de les employer pour creer un affichage a destination de l'utilisateur 
final, qui les trouverait pour le moins obscures et peu « parlantes ». 

Exemple 5-1. Creation d'un tableau multidimensionnel 

<?php 

$tabmulti=array(array( "1 igne 0-colonne 0", "ligne 0-colonne 1", "ligne 0-colonne 2"), 

*»array("l igne 1-colonne 0", "ligne 1-colonne 1", "ligne 1-colonne 2"), 

*»array("l igne 2-colonne 0", "ligne 2-colonne 1", "ligne 2-colonne 2"), 

*»array("l igne 3-colonne 0", "ligne 3-colonne 1", "ligne 3-colonne 2")); 

echo "<h3>Tableau multidimensionnel</h3><table border='l' width=\"100£ \"> <tboby>"; 

for ($i=0;$i<count($tabmulti ) ;$i++) 

{ 

for($j=0;$j<count($tabmulti[$i]);$j++) 

{ 

echo "<td><h3> .. ", Stabmulti [$i ][$j] , " .. </h3X/td>"; 

} 

echo "</tr>"; 
} 

echo " </tbody> </table> "; 
?> 



Le resultat obtenu est celui de la figure 5-1. 
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Creer des suites 



Pour creer des tableaux dont les elements sont des suites de nombres et eventuellement 
de lettres, comme vous le verrez a l'exemple 5-2, vous pourriez envisager d'utiliser une 
boucle for. PHP propose toutefois une fonction rangeO, qui permet de realiser cette 
operation en une seule ligne de code. Sa syntaxe est la suivante : 

array ranged'nt mini ,int maxi ) 

Cette fonction retourne un tableau indice contenant tous les entiers compris entre les 
valeurs mini et maxi. 

Pour creer des suites de lettres, le moyen le plus classique serait d'ecrire une boucle utili- 
sant la fonction chr(n), qui retourne le caractere dont le code ASCII est n. Pour creer un 
tableau contenant la suite de lettres de "A" a "Z", vous utiliseriez done les valeurs de n 
comprises entre 65 et 90, ou 97 et 122 pour la suite de "a" a "z". Au lieu de cela, PHP 
vous permet d'utiliser la fonction range ( ), dont la syntaxe est alors la suivante : 

$tabalpha = rangeC'A" ,"Z" ) 

Cette possibilite n'est pas mentionnee dans la documentation officielle, d'ou Putilite de 
P experimentation personnelle. 



Script de tableau 

Dans les resultats affiches par le script, pour les tableaux crees a I'aide de la fonction range (), le premier 
indice est alors qu'avec une boucle for il serait possible de choisir I'indice 1. 



Exemple 5-2. La creation de suites 

<?php 

//Suite de nombres de 1 a 10 

$tabnombre= ranged, 10); 

print_r($tabnombre) ; 

echo "<hr>"; 

//Suite de lettres de a a z avec une boucle 

for($i=97;$i<=122;$i++) 

{ 

$tabalpha[$i-96]=chr($i); 
} 

print_r($tabalpha) ; 
echo "<hr>"; 

//Suite de lettres de A a M avec rangeO 
$tabalpha2 = ranget "A" , "M") ; 
print_r($tabalpha2) ; 
?> 

Le script de l'exemple 5-2 affiche les resultats suivants : 



Array ( [0] => 1 [1] => 2 [2] => 3 [3] => 4 [4] => 5 [5] => 6 [6] => 7 [7] => 8 [8] 
=> 9 [9] => 10 ) 
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Array ( [1] => a [2] => b [3] => c [4] => d [5] => e [6] => f [7] => g [8] => h [9] => 

i [10] => j [11] => k [12] => 1 [13] => m [14] => n [15] => o [16] => p [17] => q [18] 

=> r [19] => s [20] => t [21] => u [22] => v [23] => w [24] => x [25] => y [26] => z ) 

Array ( [0] => A [1] => B [2] => C [3] => D [4] => E [5] => F [6] => G [7] => H [8] => 
I [9] => J [10] => K [11] => L [12] => M ) 



Creer un tableau a partir d'une chaine 

Une derniere facon utile de creer des tableaux consiste a decomposer une chaine de 
caracteres en un ensemble de sous-chaines, dont chacune devient un element de tableau. 

Le critere de coupure de la chaine est un caractere quelconque a choisir par le program- 
meur. Cela peut etre une espace, pour decomposer une phrase en mots au sens courant du 
terme, ou le caractere "@", pour separer le nom d'utilisateur de celui de son serveur de 
courrier dans une adresse e-mail. 

Cette operation peut etre effectuee tres simplement au moyen de la fonction explodeO, 
dont la syntaxe est la suivante : 

| array explodetstring "coupe", string Schaine, [int nbmax]) 

Cette fonction retourne un tableau compose des sous-chaines de Schaine creees avec 
le critere de coupure contenu dans la chaine "coupe", l'entier nbmax facultatif donnant le 
nombre maximal de sous-chaine desire. 

Le code suivant : 

<?php 

$chaine="La cigale et la fourmi"; 

Stabmot = explodeC ", Schaine); 

print_r($tabmot) ; 

?> 

affiche la structure du tableau $tabmot : 

Array ( [0] => La [1] => cigale [2] => et [3] => la [4] => fourmi ) 

En passant comme premier parametre le caractere "@" , vous pouvez decomposer une 
adresse e-mail avec le code suivant : 

<?php 

$adresse="machin@wanadoo.f r" ; 

$ tabs ite=expl ode ( "@" ,$adresse) ; 

echo "L'util isateur est : {$tabsite[0]} et son serveur mail est {$tabsite[l]} "; 

?> 



qui affiche 



L'util isateur est : machin et son serveur mail est wanadoo.fr 
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Compter le nombre de valeurs d'un tableau 

Vous venez de voir la distinction entre le nombre d'elements d'un tableau et le nombre de 
valeurs qu'il contient. Vous allez maintenant decouvrir comment determiner le nombre 
exact de valeurs d'un tableau. 

Vous avez deja employe la fonction count ( ) pour determiner le nombre d'elements d'un 
tableau. Quand un tableau n'a qu'une seule dimension, la valeur obtenue correspond au 
nombre de valeurs contenues dans le tableau. Si le tableau est multidimensionnel, en 
revanche, la valeur retournee par count( ) n'est pas egale au nombre de valeurs. 

L'exemple 5-3 fournit une methode permettant de determiner le nombre de valeurs d'un 
tableau a l'aide d'une boucle. Cette derniere examine le type de chacun des six elements 
du tableau $tabdi v, qui contient des chaines de caracteres, des tableaux et des entiers. 

Si l'un des elements est un tableau, vous reutilisez la fonction count () pour trouver le 
nombre de valeurs qu'il contient et incrementez le compteur $nb_val d'autant, sauf pour 
les entiers et les chaines, pour lesquels vous l'incrementez d'une unite seulement. Vous 
obtenez de la sorte le nombre total de valeurs. 

Si le tableau avait trois dimensions au lieu de deux, il vous faudrait ajouter une boucle for 
supplementaire pour arriver au meme resultat. 

Le listing de l'exemple 5-3 fournit le resultat suivant : 

Le tableau $tabdiv contient 6 elements 
Le tableau $tabdiv contient 11 valeurs 



Exemple 5-3. Comptage du nombre de valeurs 

<?php 

//Compte du nombre d'elements 

$tabdiv=array(" Bon jour", "Web", array ("1-0", "1-1 ","1-2"), 1970, 2009, 
'••array ("3-0", "3-1", "3-2", "3-3")); 

echo "Le tableau \$tabdiv contient " ,count($tabdiv) , " elements <br />"; 
//ou encore: echo "Le tableau \$tabdiv contient " .sizeof (Stabdiv) ," elements <br />" 
//Compte du nombre de valeurs 
$nb_val=0; 

for ($i=0;$i<count($tabdiv);$i++) 
{ 
if (gettype($tabdiv[$i])=="array") 



$nb_val+=count($tabdiv[$i]) ; 
else 

$nb_val++; 



echo 
?> 



'Le tableau \$tabdiv contient ",$nb_val," valeurs <br />"; 
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La fonction sizeo1() 

La fonction sizeof ( ) est un alias de la fonction countO. Vous pouvez I'employer a la place dans tous 
les exemples precedents. 



Dans le meme ordre d'idee, vous pouvez etre amene a vouloir compter non pas le nombre 
total de valeurs d'un tableau mais le nombre de valeurs differentes qu'il contient. 

La fonction array_count_val ues(), dont la syntaxe est la suivante : 

$result = array_count_values($tab) 

retourne le tableau associatif $result, ayant pour cles les valeurs du tableau $tab et pour 
valeur associee a chaque cle le nombre de fois que chacune apparait dans le tableau $tab. 

Cette fonction peut vous permettre de realiser une analyse statistique des donnees conte- 
nues dans un tableau. Cela se revele pratique lorsque les donnees sont nombreuses, 
comme apres une requete de selection dans une base de donnees. 

Le listing 5-4 offre une illustration de l'emploi de cette fonction. La fonction count ( ) affi- 
che le nombre d' elements du tableau $tab. La fonction array_count_values() affiche le 
nombre de valeurs differentes que contient le tableau. Enfin, la fonction $result donne 
des informations statistiques sur le nombre d'occurrences de chaque valeur. 

Exemple 5-4. Comptage du nombre de valeurs 

<?php 

$tab= array ("Web", "Internet", "PHP", "JavaScript", "PHP", "ASP", "PHP", "ASP"); 

$result=array_count_val ues($tab) ; 

echo "Le tableau \$tab contient " ,count($tab) ," elements <br>"; 

echo "Le tableau \$tab contient " ,count($resul t) , " valeurs differentes <br>"; 

print_r($result) ; 

?> 

Le listing de 1' exemple 5-4 fournit le resultat suivant : 

Le tableau Stab contient 8 elements 

Le tableau $tab contient 5 valeurs differentes 

Array ( [Web] => 1 [Internet] => 1 [PHP] => 3 [Javascript] => 1 [ASP] => 2 ) 



La fonction array_count_values() 

La fonction a rray_count_val ues ( ) ne s'applique que si les elements sont de type i nteger, double ou 
string mais pas de type array. Elle n'est pas adaptee pour compter le nombre de valeurs d'un tableau 
multidimensionnel. 



En comparaison des fonctions print_r() et var_dump(), que vous avez utilisees pour affi- 
cher l'ensemble des elements d'un tableau, les boucles de lecture des elements de 
tableau, de leur indice et de leur cle offrent un meilleur affichage, sous forme de tableau 
XHTML, par exemple. 
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Ce sont ces mefhodes que vous mettrez en pratique dans les sections suivantes et dans la 
suite de l'ouvrage pour lire les donnees d'un tableau et les restituer dans des pages 
XHTML. 



Lire les elements des tableaux 

Comme vous venez de le voir, il est souvent utile d'afficher 1' ensemble des informations 
contenues dans un tableau, que ce soit la valeur des elements qu'il contient ou les couples 
indice-valeur et cle-valeur des tableaux respectivement indices ou associatifs. 

Cette section presente un large eventail des possibilites de lecture des tableaux. Ces 
dernieres repondent a tous les besoins, y compris la lecture integrate des tableaux multi- 
dimensionnels. 

Lire avec une boucle for 

La boucle for a besoin d'un parametre d'arret. Vous allez employer pour cela la fonction 
countt ), qui retourne le nombre total d'elements de la boucle. L'utilisation de la variable 
$i comme compteur de la boucle permet de parcourir l'ensemble des valeurs du tableau 
unidimensionnel. 

Le listing de l'exemple 5-5 donne un exemple de lecture d'un tableau indice. 
; *~ Exemple 5-5. Lecture d'un tableau indice a I'aide de la boucle for 

<?php 

$montab=array(" Paris" ."London" , "Briissel ") ; 

for ($i=0;$i<count($montab) ;$i++) 

{ echo "L'element $i est $montab[$i ]<br />";} 

?> 

Le listing fournit le resultat suivant : 

L'element est Paris 
L'element 1 est London 
L'element 2 est Briissel 

La boucle for peut permettre la lecture de tableaux multidimensionnels, a condition 
d'ecrire autant de niveaux de boucles qu'il y a de dimensions dans le tableau. 

Le listing de l'exemple 5-6 donne un exemple de lecture de ce type de tableau a I'aide de 
deux boucles imbriquees. La premiere parcourt les elements du tableau $cl ients a I'aide 
d'un compteur $i . Comme chacun de ces elements est un tableau, la seconde boucle 
de compteur $j lit l'ensemble des elements contenus dans ces tableaux. 

L'affichage s'effectue sous la forme d'un tableau XHTML avec en-tete et pied a I'aide 
des elements XHTML <thead> et <tfoot>. Ces derniers sont tres utiles pour ameliorer la 
presentation des tableaux, notamment des longs tableaux. 
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Exemple 5-6. Lecture d'un tableau multidimensionnel indice a I'aide de la 
boucle for 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<title>Lecture d'un tableau indice avec une boucle for</title> 
</head> 
<body> 
<div> 
<?php 

//Creation du tableau 

$clients = arraytarray ("Leparc", "Paris", "35"), arrayC'Duroc" , "Vincennes" , "22"), 
array( "Denoel " , "Saint Cloud" , "47" ) ) ; 
/*A1 ternati ve a la creation du meme tableau 
$tabl= arrayC'Leparc" , "Paris" , "35") ; 
$tab2= arrayC'Duroc" ."Vincennes" ,"22") ; 
$tab3= arrayC'Denoel", "Saint Cloud" , "47") ; 
$clients=array($tabl,$tab2,$tab3); */ 
echo "<table border=\"l\" width=\"100%\" >"; 
//En tete du tableau 

echo "<thead><tr> <th> Client </th><th> Norn </th><th> Ville </th><th> Age </thX/tr> 
*</thead>"; 
//Pied de tableau 

echo "<tfoot> <tr><th> Client </th><th> Norn </th><th> Ville </th><th> Age </thX/tr> 
*</tfootXtbody>"; 
//Lecture des indices et des valeurs 
for ($i=0;$i<count($clients);$i++) 
{ 

echo "<tr><td al ign=\"center\"Xb>$i </bX/td>"; 

for($j=0;$j<count($clients[$i]);$j++) 

{ 
echo "<tdXb>",$clients[$i][$jL" </bX/td>"; 

} 

echo "</tr>"; 
} 

?> 

</tbody> 
</table> 
</div> 
</body> 
</html> 
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Figure 5-2 

Lecture d'un tableau a deux dimensions et affichage sous forme de tableau XHTML 



Lire avec une boucle while 

La boucle for necessite par definition de connaitre le nombre d'iterations a effectuer tel 
que fourni par la fonction countt ). Ce n'est pas le cas avec la boucle whi 1 e, qui se revele 
de ce fait plus efficace dans le cas d'un tableau retourne apres une requete sur une base 
de donnees, le nombre de reponses etant bien evidemment inconnu. 

Pour un tableau a une seule dimension, l'expression booleenne contenue dans l'instruc- 
tion while est isset($tab[$i ]). Cette expression prend la valeur TRUE tant que l'element 
designe par $tab[$i ] existe. Sinon, elle prend la valeur FALSE, ce qui est le cas en fin de 
tableau. 

La variable $i etant incrementee dans la boucle, isset($tab[$i]) prend la valeur FALSE 
quand $i depasse le nombre d'elements du tableau $tab, ce qui provoque l'arret de la 
boucle. 

Par precaution, vous pouvez initialiser la variable $1 a avant de demarrer la boucle de 
lecture au cas ou elle aurait ete utilisee auparavant dans le script et conserverait une 
valeur. L'exemple 5-7 illustre la lecture d'un tableau indice a une dimension qui fournit 
le meme affichage que le listing de l'exemple 5-5. 

*~ Exemple 5-7. Lecture d'un tableau indice a I'aide de la boucle while 

<?php 

$montab=array(" Paris" ."London" , "Briissel ") ; 

$i=0; 

while(isset($montab[$i]) ) 

{ 

echo "L'element $i est $montab[$i]<br />"; 

$i++; 



?> 
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Si le tableau est multidimensionnel, vous operez de meme au moyen de deux boucles 
whi 1 e imbriquees. L'expression booleenne de la seconde boucle est i sset( $ t a b [ $ i ] [$j] ). 
Elle est evaluee de la meme facon que precedemment. 

Le compteur $j du nombre d' elements est egalement initialise a avant le debut de la 
boucle — c'est ici indispensable pour pouvoir lire les lignes suivantes — et est incre- 
mente apres chaque affichage d'un element. 

Exemple 5-8. Lecture d'un tableau indice multidimensionnel a I'aide de la 
boucle while 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 
<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture d'un tableau indice avec une boucle while</title> 
</head> 
<body> 
<div> 
<?php 

//creation du tableau 

$clients = array(array ("Leparc", "Paris", "35"), array("Duroc" , "Vincennes", "22"), 
array( "Denoel " , "Saint Cloud" , "47")) ; 
//Ajout d'un element 

$clients[7] = arrayC'Duval " , "Marseil le" , "76") ; 
//creation du tableau HTML 

echo "<table border=\"l\" width=\"100%\" XtheadXtr> <th> Client </th><th> Norn 
*</thXth> Ville </th><th> Age </th></tr></thead> <tfoot> <tr><th> Client </th> 
*<th> Norn </th><th> Ville </th><th> Age </thX/trX/tfootXtbody>" ; 
//Lecture des elements 
$i=0; 

while(isset($clients[$i])) 
{ 
echo "<tr><td align=\"center\"Xb>$i </bX/td>"; 
$j=0; 

while(isset($clients[$i][$j])) 
{ 
echo "<td><b>",$clients[$i][$j]," </bX/td>"; 

} 

echo "</tr>"; 

$i++; 
} 

?> 

</tbody> </table> 
</div> 
</body> 
</html> 
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Le resultat de l'exemple 5-8 est identique a celui de la figure 5-2 realise avec une boucle for. 



Indice non consecutif 

Si, apres avoir defini le tableau $cl i ents, vous lui ajoutez un element au moyen de I'instruction : 
$clients[7] = arrayC'Duval " , "Marseil le" , "76" ) ; 

creant ainsi un indice non consecutif aux trois premiers, cet element n'est pas lu dans la boucle. Cette 
methode n'est done pas adaptee a ce cas particulier. 



Lire a I' aide de la fonction each() 

Pour pallier 1' inconvenient signale a la remarque precedente, il est possible d'utiliser une 
autre methode de lecture. Cette derniere fait appel a la fois a une boucle while et a la 
fonction each( ), qui recoit comme parametre une variable de type array. Cette derniere a 
la particularite de retourner un tableau a quatre elements qui contient les informations sur 
1' element courant du tableau passe en parametre puis de pointer sur 1' element suivant. 

La syntaxe de la fonction each( ) est la suivante : 

$element = each($tab) 

Stab est le tableau a lire et $el ement le tableau de resultats contenant les informations sur 
1' element courant de Stab, sous la forme : 

• Sel ement[0], qui contient l'indice de 1' element courant. 

• Sel ement [1], qui contient la valeur de 1' element courant. 

• Selement["key"], qui contient la cle de 1 'element courant. 

• Sel ement ["value"], qui contient la valeur de 1' element courant. 

Les couples Selement[0]-Selement[l] sont generalement utilises pour recuperer les 
couples indice-valeur des tableaux indices, et les couples Selement["key"]-Selement 
["value"] pour recuperer les couples cle-valeur des tableaux associatifs. Cet usage n'a 
toutefois d'autre justification que la force de l'habitude. 

Par exemple, les deux lignes de code suivantes : 

I echo "L'element d'indice $element[0] a la valeur Selement[l]<br />"; 
echo "L'element de cle {$element[ ' key ' ]} a la valeur (Sel ement[ 'value ']}<br />"; 

affichent exactement le meme resultat. 

L'expression Sel ement=each( Stab) etant evaluee a TRUE tant que le tableau contient des 
elements, placez-la dans une boucle whi 1 e de facon a pouvoir lire l'ensemble des elements. 
Arrive a la fin du tableau, cette expression prend la valeur FALSE, ce qui arrete la boucle. 

Pour vous assurer que le pointeur interne du tableau est positionne au debut du tableau, 
vous pouvez appeler la fonction reset ( ), dont e'est le role, en utilisant comme parametre 
le tableau a lire avant de commencer la lecture. L'avantage principal de cette methode de 
lecture est de donner acces aussi bien a des tableaux indices qu'a des tableaux associatifs. 
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Comme vous pouvez le constater au listing 5-9, l'ajout d'un element apres la creation du 
tableau, en particulier avec un indice non consecutif aux precedents, ne perturbe pas la 
lecture de l'integralite du tableau, a la difference de l'exemple 5-8. 



La notation {$element['key']} 

Dans le listing 5.9, la notation {$element['key']} permet que l'element soit evalue a I'interieur de la 
chaine de caracteres. Le fait d'ecrire a la place $el ement[ ' key ' ] provoque une erreur. 



Exemple 5-9. Lecture a I'aide de la fonction each() 

<?php 

//******Lecture d'un tableau indice****** 

$montab=array( "Paris" , "London" ."Brussel") ; //indices 0,1,2 

//Ajout d'un element au tableau 

$montab[9]="Berlin"; 

//Lecture des elements 

reset($montab) ; 

while($element=each($montab) ) 

{ 

echo "L'element d'indice $element[0] a la valeur $element[l]<br />"; 

//$i++; 

} 

echo "<hr>"; 

//******Lecture d'un tableau associatif ****** 

$montab=array( " France "=>" Paris" , "Great Britain"=>" London" , "Bel gie"=>" Brussel ") ; 

//Ajout d'un element au tableau 

$montab["Deutschland"]="Berl in" ; 

//Lecture des elements 

reset($montab) ; 

while($element=each($montab) ) 

{ 

echo "L'element de cle {$element[ ' key ' ]} a la valeur {$element[' val ue' ]}<br />" 

//$i++; 

} 

?> 



Le listing 5-9 affiche le resultat suivant : 



L'element d'indice a la valeur Paris 

L'element d'indice 1 a la valeur London 

L'element d'indice 2 a la valeur Brussel 

L'element d'indice 9 a la valeur Berlin 

L'element de cle France a la valeur Paris 

L'element de cle Great Britain a la valeur London 

L'element de cle Bel gi e a la valeur Brussel 

L'element de cle Deutschland a la valeur Berlin 
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La fonction each( ) offre une lecture encore plus perfectionnee du fait qu'elle s' applique 
a des tableaux multidimensionnels indices ou meme associatifs d'une maniere plus 
simple que les methodes precedentes. 

II suffit pour cela d'utiliser deux boucles whi 1 e imbriquees. La premiere recupere les indi- 
ces de chacun des elements du tableau. Comme chaque element est lui-meme un tableau, 
la seconde recupere les cles et valeurs contenues dans chacun d'eux. 

Le listing 5-10 donne un exemple de lecture de tableaux multidimensionnels, l'un indice 
et l'autre associatif. Malgre l'ajout d'un element apres la creation du tableau, la lecture 
est integrale. 

Exemple 5-10. Lecture de tableaux multidimensionnels a I'aide de la fonction 
each() 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 
<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture d'un tableau indice avec une boucle while</title> 
</head> 
<body> 
<div> 

<?php 
//******************************** 

//Tableau indice mul tidimensionnel 
//••it***************************** 

//Creation du tableau 

$clients ■ array( 

array ("Leparc", "Paris", "35"), 

array( "Duroc" , "Vincennes" , "22"), 

array( "Denoel " , "Saint Cloud" , "47" ) ) ; 

//Ajout d'un element 

$clients[7] = arrayC'Duval " , "Marseil le" , "76" ) ; 

echo "<table border=\"l\"Xtbody>" ; 

while($element=each($cl ients) ) 

{ 

echo "<tr> <td> element <b> $element[0] </b></td>"; 

while($val=each($element[l])) 

{ 
echo "<td><b>",$val[l]," </b></td>"; 

} 

echo "</tr>"; 
} 
echo " </tbody> </table> <hr />"; 
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/ f ************************************ 

//Tableau associatif mul tidimensionnel 
//it*********************************** 

//Creation du tableau 

$clients = array( 

arrayt "cl ientl"=>"Leparc" , "vil 1 el "=>" Paris" , "agel"=>"35") , 

array( "cl ient2"=>"Duroc" , "ville2"=>"Vincennes" , "age2"=>"22") , 

array( "cl ient3"=>"Denoel " , "vil le3"=>" Saint Cloud" ,"age3"=>"47" ) ) ; 

//ajout d'un element 

$clients[7] = arrayC'cl ient7"=>"Duval " ,"vil le7"=>"Marseille" , "age7"=>"76") ; 

echo " <table border=\"l\"Xtbody> "; 

//Lecture des elements 

while($element=each($cl ients) ) 

{ 

echo "<tr><td> element <b> $element[0] </b></td>"; 

while($val=each($element[l])) 

{ 
echo "<td> cle :<b>" ,$val [0] , "</bX/td><tdXb>" ,$val [1] , " </bX/td>"; 

} 

echo "</tr>"; 
} 

echo " </tbody> </table>"; 
?> 

</div> 
</body> 
</html> 

La figure 5-3 illustre le resultat de ce listing sous la forme d'un tableau XHTML affi- 
chant a la fois les indices, ou les cles selon le cas, et toutes les valeurs contenues dans les 
tableaux $cl ients. 
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Lire avec each() et listQ 

La fonction 1 i s t ( ) permet d ' affecter a N variables la valeur des N premiers elements d ' un 
tableau indice. Sa syntaxe est la suivante : 

list($x,$y,$z,...) = Stab 

La variable $x prend la valeur du premier element du tableau $tab (d'indice ou de 
premiere cle). $y prend la valeur du deuxieme element, et ainsi de suite. 

Le code suivant : 

I$tab=array("Paris" , "London" , "Briissel " ) ; 
list($x,$y) = Stab; 
echo "Les deux premiers elements sont : $x et $y <br />"; 

affiche uniquement les valeurs "Paris" et "London", sans les indices, qui ne sont pas recu- 
peret. 

La fonction 1 i st( ) ne deplace pas le pointeur interne du tableau sur les elements suivants. 
Si vous appelez de nouveau list($x,$y), vous obtenez les memes valeurs. 

L'interet de cette fonction dans la lecture des tableaux peut done paraitre limite. Si vous 
l'associez cependant a la fonction each( ), son role appreciable devient plus evident. En 
effet, eachO deplace le pointeur interne sur les elements suivants, tandis que listO 
permet de lire les deux premiers elements du tableau retourne par la fonction eachO, 
elements qui contiennent respectivement l'indice et la valeur du tableau a lire. 

Si vous ecrivez le code : 

list($x,$y) = each($tab) 

la variable $x contient l'indice ou la cle, et $y la valeur associee. 

L'ensemble listO et eachO place comme expression booleenne dans une boucle while 
vous permet done de lire l'integralite du tableau en recuperant les indices, ou les cles 
selon les cas. 

Le listing 5-11 donne un exemple d' utilisation de la fonction 1 i st( ) ainsi que de lecture 
de tableaux indices et associatifs. 



Plusieurs virgules 

Si vous ecrivez : 

list($x,,$y,,$z) = $tab 

en placant plusieurs virgules de suite, $x contient bien le premier element de Stab, mais $y contient le 

troisieme et $z le cinquieme. Cette particularite peut se reveler utile, par exemple, pour ne recuperer que 

les elements d'indice pair ou impair. 



Attention 

La fonction 1 i st ( ) ne s'applique pas aux tableaux associatifs, desquels elle ne recupere ni cles ni valeurs. 



Les tableaux 

Chapitre 5 

Exemple 5-1 1 . Lecture avec Hst() et each() 

<?php 

//listO avec un tableau indice 
$tab=array( "Paris" ."London" , "Briissel ") ; 
list($x,$y) = Stab; 

echo "Les deux premiers elements sont : $x et $y <hr />"; 
//listO avec un tableau associatif (ne fonctionne pas) 
S tab=ar ray (" France "=>" Paris" , "Great Britain"=>" London" , " Bel gie"=>" Briissel ") ; 
list($x,$y) = Stab; 
echo "Les deux premiers elements sont : $x et Sy <hr />"; 

//************************* 

//Lecture de tableau indice 
//************************* 

Stab=array( "Paris" ."London" , "Briissel ") ; 

while(list(Sindice,Svaleur) - each(Stab) ) 

{ 

echo "L'element d'indice <b>Sindice</b> a la valeur <b>$valeur</b><br>" ; 

} 

echo"<hr />"; 

//***************************** 

//Lecture de tableau associatif 
//it**************************** 

Stab=array( " France "=>" Paris" , "Great Bri tai n"=>" London" , 

*»" Bel gie"=>" Briissel ") ; 

while(list(Scle,Svaleur) = each(Stab) ) 

{ 

echo "L'element de cle <b>Scle</b> a la valeur <b>Svaleur</b><br />"; 

} 

?> 

La lecture des tableaux affiche les resultats suivants : 

Les deux premiers elements sont : Paris et London 

Notice: Undefined offset: 1 in c:\eyrolles\php5\tableaux\tableaull.php on line 8 

Notice: Undefined offset: in c:\eyrolles\php5\tableaux\tableaull.php on line 8 
Les deux premiers elements sont : et 
L'element d'indice a la valeur Paris 
L'element d'indice 1 a la valeur London 
L'element d'indice 2 a la valeur Briissel 

L'element de cle France a la valeur Paris 
L'element de cle Great Britain a la valeur London 
L'element de cle Bel gi e a la valeur Briissel 

Remarquez l'avis d'erreur si vous utilisez la fonction 1 i st( ) seule pour un tableau asso- 
ciatif. 
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Linstruction foreach 

Plus pratique encore que les methodes precedentes, l'instruction foreach () n'est utilisa- 
ble qu'a partir des versions 4 de PHP. Elle se revele particulierement efficace pour les 
tableaux associatifs mais fonctionne egalement pour les tableaux indices. 

Contrairement a la boucle for, l'instruction foreach( ) ne necessite pas de connaitre par 
avance le nombre d'elements du tableau a lire. Sa syntaxe varie en fonction du type de 
tableau. 

Pour les tableaux indices, vous ecrivez le code suivant : 

foreach($tab as Svaleur) 

{ 

//bloc de code utilisant les valeurs de la variable Svaleur; 

} 

Indispensable, le mot-cle as permet de recuperer successivement toutes les valeurs des 
elements du tableau $tab dans la variable $valeur, mais sans les indices correspondants. 

Pour les tableaux associatifs, vous disposez d'une syntaxe plus perfectionnee. 

Le code suivant : 

foreach($tab as $cle=>$valeur) 

{ 

//bloc de code utilisant les valeurs des variables $cle et $valeur; 

} 

permet de recuperer dans la variable $cl e les valeurs et les cles successives des elements. 
De plus, si le tableau est indice numeriquement, la variable $cl e contient cet indice. 

Si vous disposez d'un serveur equipe des versions 4 et suivantes de PHP, ces methodes 
de lecture sont particulierement recommandees du fait de leur simplicite d'ecriture et de 
leur rapidite d' execution. 

Vous allez maintenant envisager un ensemble d'exemples d'utilisation de l'instruction 
foreach appliquee a la lecture de tableaux de formes diverses. 

Lecture de tableaux indices ou associatifs 

Le listing 5-12 effectue une lecture de tableaux indices et associatifs a l'aide de l'instruc- 
tion foreach avec et sans recuperation des indices ou cles des elements. Le resultat est 
similaire a celui obtenu avec les fonctions 1 ist( ) et each( ) de la section precedente, mais 
le code est plus elegant. 

Exemple 5-12. Lecture de tableaux a l'aide de l'instruction foreach 

<?php 

//Lecture de tableau indice sans recuperation des indices 
//******************************************************* 

$tab=ar ray ("Paris" , "London" , "Briissel " ) ; 

echo "<H3>Lecture des valeurs des elements </H3>"; 
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foreach($tab as $ville) 

{ 

echo "<b>$ville</b> <br>"; 

} 

echo"<hr>" ; 

//•••it*************************************************** 

//Lecture de tableau indice avec recuperation des indices 
//******************************************************* 

echo "<h3>lecture des indices et des valeurs des elements </h3>"; 

foreach($tab as $indice=>$ville) 

{ 

echo "L'element d'indice <b>$indice</b> a la valeur <b>$ville</b><br>" ; 

} 

echo"<hr>" ; 

//••-it***************************************************** 

//Lecture de tableau associatif avec recuperation des cles 
//it******************************************************* 

$ tab2=a r ray ("France"=>" Paris" , "Great Bri tai n "=>" London" , "Belgie"=>"Briissel ") ; 

echo "<h3>lecture des cles et des valeurs des elements</h3>" ; 

foreach($tab2 as $cle=>$vil le) 

{ 

echo "L'element de cle <b>$cle</b> a la valeur <b>$vil le</b> <br>"; 

} 

echo"<hr>" ; 

?> 

Lecture d'un tableau multidimensionnel 

L'exemple 5-13 illustre la lecture du tableau multidimensionnel et associatif Sclients 
repertoriant un ensemble de clients dont chaque element de premier niveau est lui-meme 
un tableau associatif contenant les caracteristiques de chaque client. 

Ce tableau multidimensionnel contient deux boucles foreach imbriquees. La premiere 
recupere la cle de chacun des elements du tableau Sclients dans la variable $cle et son 
contenu de type array dans la variable $tab. La seconde boucle lit chaque tableau $tab en 
recuperant chaque cle contenue dans la variable $ key et la valeur de chaque element dans 
la variable $val eur. L'affichage se fait dans un tableau XHTML. 

La figure 5-4 donne un apercu du resultat affiche par ce script. 

Exemple 5-13. Lecture de tableaux multidimensionnels avec foreachf) 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 
<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture d'un Tableau multidimensionnel avec foreach( )</title> 
</head> 
<body> 
<div> 
<?php 



PHP 5 



le l"=>"Paris","age 1"=>"35"), 
e 2"=>"Vincennes","age 2"=>"22"), 
le 3"=>"St Cloud", "age 3"=>"47")I 



//Creation du tableau 

$clients - array( 

"client l"=>array("nom l"=>"Leparc" , "vi 

"client 2"=>array("nom 2"=>"Duroc" , "vil 

"client 3"=>array("nom 3"=>"Denoel " , "vi 

//Ajout d'un element 

$cl ients["cl ient 7"] = arrayC'nom 7"=>"Duval " , "vil le 7"=>"Marsei 

echo "<table border=\"l\" width=\"100%\" XtheadXtr> <th> Client 

*<th> Ville </th><th> Age </thX/trX/thead><tbody>" ; 

foreach($clients as $cle=>$tab) 

{ 

echo "<tr><td al ign=\"center\"Xb> $cle </bX/td>"; 

foreach($tab as $key=>$valeur) 



le","age 7"=>"76"); 
C/thXth> Nom </th> 



echo 

} 

echo " 
} 
?> 


"<td> $key : 


<b> 


$Vc 


leur </bX/td>"; 








</tr 


>"; 
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Figure 5-4 

Lecture d'un tableau multidimensionnel associatif avec foreach() 



Manipuler des tableaux 

PHP dispose d'un grand nombre de fonctions permettant d'effectuer routes sortes de 
manipulations de tableaux existants. Citons notamment l'extraction, l'ajout ou la 
suppression d'une partie des elements, la fusion ou l'intersection de plusieurs tableaux, 
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diverses operations de tri des elements ou des cles ou encore 1' application d'une fonction 
a l'ensemble des elements. 

Extraire une partie d'un tableau 

A partir d'un tableau donne, il est possible de creer un nouveau tableau comme sous- 
ensemble du tableau initial et ne contenant qu'un nombre determine de ses elements. 
Cette operation est realisee a l'aide de la fonction array_sl 1ce( ), qui permet d'effectuer 
divers types d' extractions. 

La syntaxe de la fonction array_sl i ce( ) est la suivante : 

$sous_tab = array_sl ice(array Stab, i nt ind, i nt nb) 

Cette fonction ne modifie pas le tableau initial mais retourne le sous-tableau dans la 
variable $sous_tab. Sa manipulation pouvant se reveler relativement complexe en fonc- 
tion des valeurs des parametres ind et nb, nous envisageons ci-apres tous les cas possibles : 

• Si ind et nb sont positifs, le tableau $sous_tab contient nb elements du tableau initial 
extrait en commencant a l'indice i nd. 

Par exemple, array_slice($tab,2,3) retourne un tableau comprenant trois elements 
extraits a partir de l'indice 2. II contient done les elements d'indice 2, 3 et 4 du tableau 

$tab. 

• Si le parametre i nd est negatif et que nb est positif, le compte des elements se fait en 
partant de la fin du tableau Stab, le dernier se trouvant affecte virtuellement de l'indice 
-1, l'avant-dernier de l'indice -2, et ainsi de suite. Le parametre nb designe encore le 
nombre d'element a extraire. 

Par exemple, array_slice($tab,-5,4) retourne quatre elements de $tab extraits en 
commencant au cinquieme a partir de la fin. 

• Si ind est positif et nb negatif, le tableau $sous_tab contient les elements de $tab 
extraits en commencant a l'indice ind et en s'arretant a celui qui a l'indice negatif 
virtuel nb (toujours en commencant par la fin). 

Par exemple, array„slice($tab,2,-4) retourne tous les elements a partir de l'indice2 
jusqu'a la fin, sauf les quatre derniers. 

• Si ind et nb sont negatif s, le tableau $ so us Jab contient les elements de $tab extraits en 
commencant a l'indice negatif ind et en s'arretant a celui d'indice negatif nb. 

Par exemple, array_slice($tab,-5,-2) retourne trois elements compris entre les indi- 
ces virtuels -5 compris et -2 non compris. 

La mise en pratique de l'exemple 5-14 donne deux types d'utilisation de la fonction 
array^sl i ce( ). Le premier n'utilise que des parametres positifs et s'applique a un tableau 
multidimensionnel dont les elements sont des tableaux indices ou associatifs. Le second 
envisage toutes les possibilites de valeurs pour les parametres ind et nb en les appliquant 
a un tableau simple. 
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Exemple 5-14. Utilisation de la fonction array _slice() 

<?php 

echo"Exemple Kbr />" ; 

$tab= array("UN"=>range(l,5),''DEUX"=>range("a'',"c"),range("A'',"E''),range(ll,15)); 

echo "Structure du tableau initial :<br />"; 

print_r($tab) ; 

echo "<hr />"; 

$soustab = array_sl ice($tab,l ,2) ; 

echo"array_slice(\$tab,l,2) donne : "; 

print_r($soustab) ; 

echo "<hr />"; 

echo"Exemple 2<br>"; 

$heros= arrayC'Spock" ."Batman" , "Dark Vador" , "Hal " , "Frodo" , "Sky Wal ker" , "Amidala" , 

*"Alien"); 

echo "Structure du tableau initial :<br>"; 

print_r($heros) ; 

echo "<hr />"; 

//Extrait des 5 premiers 

echo "array_slice(\$heros ,0,5)" ; 

$prem=array_sl ice($heros,0,5) ; 

print_r($prem) ; 

echo "<hr />"; 

//Extrait des 5 derniers (le dernier est considere comme ayant 1'indice -1 et non 

* pas 0) 

$der=array_sl ice($heros,-5,5); 

echo"array_sl ice(\$heros,-5,5) " ; 

print_r($der) ; 

echo "<hr />"; 

//Extrait de 3 noms en commencant a la position -5 

$der=array_sl ice($heros,-5,3); 

echo"array_sl ice(\$heros,-5,3) " ; 

print_r($der) ; 

echo "<hr />"; 

//Extrait des elements de 1'indice 1 jusqu'a la fin hormis les deux derniers 

$der=array_sl ice($heros,l,-2); 

echo"array_sl ice(\$heros,l,-2) " ; 

print_r($der) ; 

echo "<hr />"; 

//Extrait des elements de 1'indice -5 jusqu'a la fin hormis les deux derniers 

$der=array_sl ice($heros,-5,-2) ; 

echo"array_sl ice(\$heros,-5,-2) " ; 

print_r($der) ; 

echo "<hr />"; 

?> 
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Le listing de l'exemple 5-14 affiche le resultat suivant : 



Exemple 1 

Structure du tableau initial : 

Array ( [UN] => Array ( [0] => 1 [1] => 2 [2] => 3 [3] => 4 [4] => 5 ) [DEUX] => 

Array ( [0] => a [1] => b [2] => c ) [0] => Array ( [0] => A [1] => B [2] => C [3] => 

D [4] => E ) [1] => Array ( [0] => 11 [1] => 12 [2] => 13 [3] => 14 [4] => 15 ) ) 

array_slice($tab,l,2) donne : Array ( [DEUX] => Array ( [0] => a [1] => b [2] => c ) 
[0] => Array ( [0] => A [1] => B [2] => C [3] => D [4] => E ) ) 

Exemple 2 

Structure du tableau initial : 

Array ( [0] => Spock [1] => Batman [2] => Dark Vador [3] => Hal [4] => Frodo [5] => 

Sky Walker [6] => Amidala [7] => Alien ) 

array_slice($heros,0,5)Array ( [0] => Spock [1] => Batman [2] => Dark Vador [3] => 
Hal [4] => Frodo ) 

array_slice($heros,-5,5) Array ( [0] => Hal [1] => Frodo [2] => Sky Walker [3] => 
Amidala [4] => Alien ) 

array_slice($heros,-5,3) Array ( [0] => Hal [1] => Frodo [2] => Sky Walker ) 

array_slice($heros,l,-2) Array ( [0] => Batman [1] => Dark Vador [2] => Hal [3] => 
Frodo [4] => Sky Walker ) 

array_slice($heros,-5,-2) Array ( [0] => Hal [1] => Frodo [2] => Sky Walker ) 



Ajouter et enlever des elements 

Une fois un tableau cree a l'aide de la fonction array ( ) et certaines valeurs affectees a ses 
elements, vous pouvez effectuer diverses manipulations d'ajout ou de retrait d'elements 
selon les besoins. 

La fonction : 

int array_push($tab, valeurl, valeur2,..., valeurN) 

ajoute en une seule operation les N elements passes en parametres a la fin du tableau 
designe par la variable $tab. Vous pouvez evidemment remplacer les valeurs passees en 
parametres par des variables. 

Les nouveaux indices ainsi crees ont pour valeur celle du plus grand indice existant (done 
egal a count($tab)-l ) incremente de 1 jusqu'a TV. La fonction retourne egalement le 
nouveau nombre d'elements du tableau modifie. 

Pour ajouter des elements au debut d'un tableau, vous pouvez utiliser la fonction suivante : 

int array_unshift($tab, valeurl, valeur2 valeurN) 
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Cette fonction ajoute egalement au tableau $tab les N elements passes en parametres 
mais cette fois au debut du tableau. Les indices existants sont tous decales de la valeur N, 
et la fonction retoume le nouveau nombre d'elements du tableau. 

Reciproquement, vous pouvez supprimer des elements d'un tableau a l'aide de la fonc- 
tion suivante : 

array_pop($tab) 

qui supprime le dernier element du tableau $tab et retourne cet element s'il existe ou la 
valeur NULL dans le cas contraire, par exemple si le tableau est vide ou si le parametre 
$tab n'est pas de type array. Avec les fonctions array_push() et array_pop(), le tableau 
se comporte comme une pile dotee respectivement de fonctions d'empilement et de 
depilement. 

Dans ce cas, un avertissement du type : 

I Warning: array_pop(): The argument should be an array in c:\eyrolles\php5\tableaux\ 
**tableaul5.php on line 18 

est affiche, ce qui n'est pas du meilleur effet sur les utilisateurs. Dans le doute, il est 
preferable d'utiliser la fonction gettypeO pour s'assurer que le parametre $tab est bien de 
type array. 

Pour supprimer le premier element d'un tableau, utilisez la fonction suivante : 

array_shift($tab) 

qui retourne la valeur de 1' element supprime. 

Enfin, il est possible de supprimer un element d'indice ou de cle quelconque du tableau 
Stab a l'aide de la fonction unset( ) en precisant explicitement le nom de l'element et son 
indice ou sa cle. 

Par exemple : 

unset($tab[4]) 
supprime l'element d'indice 4 du tableau $tab et 

unset ($ tab [" qua t re"]) 

l'element dont la cle est "quatre". 

Cette fonction n'a pas d'effet sur les autres indices du tableau, qui conservent tous la 
valeur qu'ils avaient avant la suppression. 

L'exemple 5-15 illustre toutes ces fonctions de modification des tableaux et affiche la 
structure du tableau apres chacune d'elles. 

Exemple 5-15. Ajout et suppression d'elements 

I<?ph P 
$tab= array(800,1492, 1515, 1789); 
print_r($tab) ; 
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echo "<hr />"; 

//Ajout au debut du tableau 

$poitiers=732; 

$nb=array_unshift( Stab, 500, $poi tiers) ; 

echo "Le tableau \$tab a maintenant $nb elements <br>"; 

print_r($tab) ; 

echo "<hr />"; 

//Ajout a la fin du tableau 

$armi=1918; 

$newnb=array_push($tab, 1870, 1914, $armi ); 

echo "Le tableau \$tab a maintenant Snewnb elements <br>"; 

print_r($tab) ; 

echo "<hr />"; 

//Suppression du dernier element 

$suppr= array_pop($tab); 

echo "Le tableau \$tab a perdu 1 'element $suppr <br>"; 

print_r($tab) ; 

echo "<hr />"; 

//Suppression du premier element 

$suppr= array_shift($tab) ; 

echo "Le tableau \$tab a perdu 1 'element Ssuppr <br>"; 

print_r($tab) ; 

echo "<hr />"; 

//Suppression de 1 'element d'indice 4 

unset($tab[4]) ; 

print_r($tab) ; 

?> 

Le resultat du listing de l'exemple 5-15 permet de suivre revolution du tableau initial au 
fur et a mesure des modifications operees : 

Array ( [0] => 800 [1] => 1492 [2] => 1515 [3] => 1789 ) 

Le tableau $tab a maintenant 6 elements 

Array ( [0] => 500 [1] => 732 [2] => 800 [3] => 1492 [4] => 1515 [5] => 1789 ) 

Le tableau $tab a maintenant 9 elements 

Array ( [0] => 500 [1] => 732 [2] => 800 [3] => 1492 [4] => 1515 [5] => 1789 [6] => 

1870 [7] => 1914 [8] => 1918 ) 

Le tableau $tab a perdu 1 'element 1918 

Array ( [0] => 500 [1] => 732 [2] => 800 [3] => 1492 [4] => 1515 [5] => 1789 [6] => 

1870 [7] => 1914 ) 

Le tableau $tab a perdu 1 'element 500 

Array ( [0] => 732 [1] => 800 [2] => 1492 [3] => 1515 [4] => 1789 [5] => 1870 [6] => 

1914 ) 

L'element d'indice 4 a ete supprime 

Array ( [0] => 732 [1] => 800 [2] => 1492 [3] => 1515 [5] => 1870 [6] => 1914 ) 

Suite a une recherche dans une base de donnees a l'aide de criteres multiples, un tableau 
peut etre amene a contenir plusieurs fois les memes valeurs pour certains criteres. Avant 
de traiter les donnees du tableau, il peut etre preferable en ce cas d'eliminer les elements 
faisant double emploi. 
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La fonction array_unique($tab) retourne un nouveau tableau ne contenant que la derniere 
occurrence de chaque valeur presente plusieurs fois dans le tableau $tab. Les indices ou 
les cles associes a chaque element sont conserves, et le tableau retourne comporte des 
« trous » dans la suite des indices si ces derniers sont numeriques. 

Par exemple, le code suivant : 

<?php 

$tab = array ("Jacques" , "Paul " ."Pierre" , "Alban" , "Paul ", "Jack" ."Paul ") ; 

$tab2 = array_unique($tab); 

print_r($tab2); 

?> 

supprime les elements d'indices 1 et 4 qui ont la valeur "Paul " pour ne conserver que 
P element d'indice 6. Vous obtenez Paffichage suivant de la structure du tableau resultant 

$tab2 : 

Array ( [0] => Jacques [2] => Pierre [3] => Alban [5] => Jack [6] => Paul ) 



Operations sur plusieurs tableaux 

II est possible d'effectuer differents types d'operations faisant intervenir plusieurs 
tableaux, qu'il s'agisse de les fusionner ou d'effectuer des operations ensemblistes, 
comme leur intersection ou leur difference. 

Fusionner des tableaux 

Si des donnees figurent dans plusieurs tableaux differents, vous pouvez etre amene a 
vouloir effectuer des operations sur ces differents tableaux afin d'obtenir un tableau 
unique contenant soit la reunion des elements de chacun en un seul, soit les elements 
communs aux deux, soit encore les elements presents dans Pun et pas dans P autre. 

Vous pouvez, par exemple, reunir deux ou plusieurs tableaux en un seul a Paide de la 
fonction array_merge( ), dont la syntaxe est la suivante : 

$tab = array_merge($tabl,$tab2,...,$tabN) 

Cette fonction retourne dans $tab Pensemble des elements presents dans les tableaux 
$tabl, $tab2, ..., $tabN. Les tableaux passes en parametres sont tous sauvegardes tels 
qu'ils etaient avant Pappel de la fonction. 

La fusion des tableaux est realisee dans les conditions suivantes : 

• Si les tableaux a fusionner sont indices, les elements du tableau passe en premier 
parametre sont conserves, ceux des autres parametres ayant les indices suivants. Les 
elements presents dans plusieurs des parametres sont presents en double dans le 
tableau final. Vous pouvez utiliser la fonction array_unique( ) pour les eliminer. 
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• Si les tableaux a fusionner sont associatifs, les cles et les associations cle-valeur sont 
preservees. Par contre, si plusieurs des parametres ont des cles communes, seule 
l'association cle-valeur du dernier parametre est conservee, et celle du tableau prece- 
dent est perdue. 

Pour ne pas perdre les informations correspondant a une meme cle, il est possible d'utiliser 
la fonction array_merge_recursive( ). Cette derniere n'efface pas la premiere valeur asso- 
ciee a une cle double mais associe a chaque cle presente plusieurs fois un tableau indice 
contenant toutes les valeurs ayant la meme cle. 

Le listing de l'exemple 5-16 donne deux exemples de fusion de tableaux, le premier pour 
les tableaux indices et le second pour les tableaux associatifs. Remarquez la disparition 
de la valeur "75" associee a la cle "Paris" du tableau $tabassl, remplacee par la valeur 
"Capital e" presente dans le tableau $tabass2 apres la fusion effectuee avec array_merge( ). 
La fonction array_nerge_recursive() preserve les deux valeurs, comme le montre le 
resultat du script. 

Exemple 5-16. Fusion de tableaux a I'aide de array_merge() 

<?php 

//Fusion de tableaux indices 

echo "Tableaux indices <br>"; 

$tabl= array ("Paris" , "Lyon" , "Marseil le" ) ; 

$tab2 = array( "Nantes" ."Orleans" , "Tours" , "Paris") ; 

$tab = array_merge($tabl,$tab2); 

echo "arrayjnerge donne: "; 

print_r($tab) ; 

echo "<hr />"; 

//Fusion de tableaux associatifs 

echo "Tableaux associatifs <br>"; 

$tabassl= arrayC'Paris" => "75", "Lyon" => "69" , "Marseil le" => "13"); 

$tabass2 = arrayC'Nantes" => "44" ."Orleans" => "45", "Tours" => "37", "Paris" => 

^•"Capitale"); 

echo "array_merge donne: "; 

$tabass = array_merge($tabassl ,$tabass2) ; 

print_r($tabass) ; 

echo "<hr />"; 

//Fusion 

echo "array_merge_recursive donne : "; 

$tabass3 = array_merge_recursi ve($tabassl,$tabass2) ; 

print_r($tabass3) ; 

?> 

Le script affiche le resultat suivant, qui montre la structure des tableaux resultant de la 
fusion : 

Tableaux indices 

arrayjnerge donne: Array ( [0] => Paris [1] => Lyon [2] => Marseille [3] => Nantes [4] 

=> Orleans [5] => Tours [6] => Paris ) 
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Tableaux associatifs 

array_merge donne: Array ( [Paris] => Capitale [Lyon] => 69 [Marseille] => 13 [Nantes] 

=> 44 [Orleans] => 45 [Tours] => 37 ) 

array_merge_recursive donne : Array ( [Paris] => Array ( [0] => 75 [1] => Capitale) 
[Lyon] => 69 [Marseille] => 13 [Nantes] => 44 [Orleans] => 45 [Tours] => 37 ) 

Vous pouvez egalement creer un tableau associatif a partir de deux autres tableaux. Le 
premier contient les cles du tableau a creer et le second les valeurs qui sont associees aux 
cles. Cette operation est realisable grace a la fonction array_combine() introduite dans 
PHP 5. Sa syntaxe est la suivante : 

array array_combine(array $tabcle, array Stabval ) 

Le code suivant : 

$tabcle - array( 'F'.'D'.'B'); 
Stabval = array( ' France' , 'Al lemagne' , 'Belgique' ) ; 
Stabasso = array_combine($tabcle, Stabval); 
print_r($tabasso) ; 

affiche le resultat : 

Array ( [F] => France [D] => Allemagne [B] => Belgique ) 

Intersection et difference de deux tableaux 

Quelques souvenirs de manipulation des ensembles devraient vous permettre de mieux 
saisir l'utilite des fonctions permettant d'obtenir soit 1' intersection de deux tableaux 
considered comme des ensembles de valeurs, soit leur difference. 

L' intersection de deux ensembles est constituee par les elements qui appartiennent a la 
fois aux deux ensembles. La difference de deux ensembles designe les elements qui 
appartiennent au premier et pas au second. En d' autres termes, sont enleves du premier 
tableau les elements qui appartiennent aussi au second. 

PHP offre deux fonctions pour realiser ces operations sur des tableaux, array_ 
intersectt ) et arrayed iff ( ). 

Pour 1' intersection de deux tableaux, la syntaxe de array_intersect( ) est la suivante : 

array array_intersect($tabl,$tab2) 

Cette fonction retourne un tableau contenant tous les elements communs aux tableaux 
Stabl et $tab2. Les indices associes aux valeurs du tableau retourne comme resultat 
correspondent a ceux du tableau passe en premier parametre. L'inversion de ces deux 
parametres ne fournit pas les memes indices (voir le resultat du listing de l'exemple 5-17 
ci-apres). 

Pour la difference de deux tableaux, la syntaxe de la fonction array_di f f ( ) est la suivante : 

array_diff($tabl,$tab2) 



Les tableaux 

Chapitre 5 

Elle retourne un tableau contenant les elements presents dans le premier parametre mais 
pas dans le second. Comme pour la soustraction de nombres, il est logique que l'inver- 
sion des parametres ne fournisse pas le meme resultat. Les indices associes aux valeurs 
dans les tableaux d'origine sont conserves. 

Si vous appliquez ces deux fonctions a des tableaux associatifs, les cles sont conservees 
dans les memes conditions. De plus, si nos exemples ne montrent que 1' intersection de 
deux tableaux, il est parfaitement licite de passer a ces fonctions un nombre quelconque 
de parametres, du moment qu'il s'agit bien de variables de type array. 

Exemple 5-17. Intersection et difference de deux tableaux 

<?php 

$tabl=array("Bl anc" , "Jaune" , "Rouge" , "Vert" , "Bleu" , "Noi r") ; 

$tab2=ar ray ("Bleu" ."Rouge" ."Violet" , "Noi r" , "Jaune" , "Orange") ; 

echo"Le tableau 1 contient les elements:<br />"; 

print_r($tabl) ; 

echo "<hr />"; 

echo"Le tableau 2 contient les elements:<br />"; 

print_r($tab2); 

echo "<hr />"; 

echo "Intersection de \$tabl et \$tab2 : "; 

$tab3=array_intersect($tabl,$tab2) ; 

print_r($tab3) ; 

echo"<br />"; 

echo "Intersection de \$tab2 et \$tabl : "; 

$tab4= array_intersect($tab2,$tabl); 

print_r($tab4) ; 

echo"<hr />"; 

$tab5= array_diff($tabl,$tab2); 

echo "Difference de Utabl et \$tab2 : "; 

print_r($tab5) ; 

echo"<br />"; 

$tab6= array_diff($tab2,$tabl); 

echo "Difference de \$tab2 et \$tabl : "; 

print_r($tab6) ; 

echo"<br />"; 

?> 

Le script affiche les resultats suivants, qui montrent bien 1' importance de l'ordre des 
parametres. 

Le tableau 1 contient les elements: 

Array ( [0] => Blanc [1] => Jaune [2] => Rouge [3] => Vert [4] => Bleu [5] => Noir ) 

Le tableau 2 contient les elements: 

Array ( [0] => Bleu [1] => Rouge [2] => Violet [3] => Noir [4] => Jaune [5] => Orange ) 
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Intersection de $tabl et $tab2 : Array ( [1] => Jaune [2] => Rouge [4] => Bleu [5] => 

Noir ) 

Intersection de $tab2 et $tabl : Array ( [0] => Bleu [1] => Rouge [3] => Noir [4] => 

Jaune ) 

Difference de Stabl et $tab2 : Array ( [0] => Blanc [3] => Vert ) 

Difference de $tab2 et $tabl : Array ( [2] => Violet [5] => Orange ) 



Trier les elements d'un tableau 

Quand une fonction retourne un tableau de valeurs, comme le font, par exemple, les 
fonctions de recherche sur une base de donnees MySQL, les valeurs des elements appa- 
raissent dans un ordre qui n'est pas necessairement celui souhaite pour l'affichage des 
informations. 

Pour ameliorer la presentation des donnees, il est souvent utile d'effectuer un tri des 
valeurs contenues dans le tableau avant de les utiliser pour creer un affichage dans une 
page Web. PHP fournit nombre de fonctions natives permettant de realiser les operations 
de tri les plus diverses. Ces operations peuvent concerner les valeurs comme les cles des 
elements de tableau, aussi bien en ordre alphabetique ASCII, direct ou inverse, que selon 
l'ordre dit « naturel » ou encore d'apres des criteres personnalises definis par le program- 
meur lui-meme. 

La quasi-totalite de ces fonctions agit directement sur le tableau qui leur est passe en 
parametre en modifiant l'ordre de ses elements ou de ses cles. Le tableau initial n'est pas 
recuperable. C'est pour cette raison que les exemples qui suivent creent des le debut du 
script une copie du tableau initial qui est reutilisee pour chaque fonction. 

Certaines fonctions sont plus appropriees a des tableaux indices et d'autres a des tableaux 
associatifs. La presentation de ces fonctions est done divisee en plusieurs sections. 

Trier des tableaux indices 

Les fonctions natives offertes par PHP permettent les operations de tri des elements des 
tableaux selon les criteres les plus varies. 

Trier selon l'ordre ASCII 

L'ordre ASCII n'a rien d'evident pour qui est habitue a l'ordre lexicographique, qui est 
celui du dictionnaire. Dans un tri ASCII, "rouge" se trouve apres "Vert" carlalettre "r" se 
trouve apres la lettre "V" . 

Les fonctions de tri dans l'ordre ASCII proposees par PHP sont les suivantes : 

• array sort($tab). Trie les valeurs du tableau $tab en ordre croissant des codes ASCII 
des caracteres qui les composent (done en tenant compte de la casse des caracteres). 
Les correspondances entre les indices et les valeurs des elements sont perdues apres 
le tri. 
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• array rsort($tab). Trie les valeurs du tableau $tab en ordre decroissant des codes 
ASCII des caracteres qui les composent. Les correspondances entre les indices et les 
valeurs des elements sont perdues apres le tri. 

• array array_reverse($tab). Inverse l'ordre des valeurs des elements de $tab. Les indi- 
ces sont evidemment perdus. 

L'exemple 5-18 illustre l'emploi de ces fonctions et affiche le tableau initial puis le 
tableau une fois trie. 

Exemple 5-18. Tri selon l'ordre ASCII 

<?php 
//it***************** 

//TABLEAU INDICE 
//****************** 

//Definition du tableau 

$tabind=array( "Blanc2" , "Jaune" ."rouge" , "Vert" , "Bleu" , "Noi r" , "BlanclO") ; 

$copie= $tabind; 

echo "<b>Tableau indice d'origine</b><br />"; 

print_r($tabind) ; 

//Fonction sortO 

echo "<hr />Tri en ordre ASCII sans sauvegarde des indices<br />"; 

$tabind=$copie; 

sort(Stabind) ; 

print_r($tabind) ; 

//Fonction rsortO 

echo "<hr /> Tri en ordre ASCII inverse sans sauvegarde des indices<br />"; 

$tabind=$copie; 

rsort($tabind); 

print_r($tabind) ; 

//Fonction array_reverse( ) 

echo "<hr /Mnversion de l'ordre des elements<br />"; 

$tabind=$copie; 

$tabrev=array_reverse($tabind) ; 

print_r($tabrev) ; 

?> 

Le script donne les resultats suivants : 

Tableau indice d'origine 

Array ( [0] => Blanc2 [1] => Jaune [2] => rouge [3] => Vert [4] => Bleu [5] => Noir [6] 

=> BlanclO ) 

Tri en ordre ASCII sans sauvegarde des indices 

Array ( [0] => BlanclO [1] => Blanc2 [2] => Bleu [3] => Jaune [4] => Noir [5] => Vert 

[6] => rouge ) 

Tri en ordre ASCII inverse sans sauvegarde des indices 

Array ( [0] => rouge [1] => Vert [2] => Noir [3] => Jaune [4] => Bleu [5] => Blanc2 [6] 

=> BlanclO ) 
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Inversion de 1'ordre des elements 
Array ( [0] => BlanclO [1] => Noir [2] 
[6] => Blanc2 ) 



=> Bleu [3] => Vert [4] => rouge [5] => Jaune 



Trier selon I'ordre naturel 

L'ordre dit naturel est plus proche de ce que chacun connait dans la vie courante. Par 
exemple, pour un tri en ordre croissant, la chaine "BlanclO" se trouve apres "Blanc2" et 
"1ZZ" avant "2AA", les chiffres etant considered comme precedant les lettres. 

II existe deux variantes de fonctions de tri selon l'ordre naturel, suivant qu'il est tenu 
compte ou non de la casse des caracteres : 

• array natsort($tab). Trie les valeurs du tableau Stab selon l'ordre naturel croissant des 
caracteres qui les composent. Le tri etant effectue en tenant compte de la casse, les 
majuscules sont placees avant les minuscules, par exemple "Vert" avant "rouge". Les 
correspondances entre les indices ou les cles et les valeurs des elements sont sauvegar- 
dees apres le tri, ce qui rend la fonction egalement applicable aux tableaux associatifs. 

• array natcasesort($tab). Trie les valeurs du tableau $tab selon l'ordre naturel crois- 
sant, sans tenir compte de la casse, ce qui correspond davantage a l'ordre courant du 
dictionnaire, dans lequel "rouge" se trouve avant "Vert". Les correspondances entre 
les indices ou les cles et les valeurs des elements sont sauvegardees apres le tri. 



for ou foreach ? 

Du fait que les fonctions array natsortO et array natcasesort( ) conservent les correspondances 
entre les indices ou les cles et les valeurs, il est deconseille d'utiliser une boucle for pour lire I'ensemble 
des donnees, au risque de perdre l'ordre cree par le tri. Une boucle foreach est indispensable, meme 
pour des tableaux indices. 



Exemple 5-19. Tri selon l'ordre naturel 

<?php 



//TABLEAU INDICE 
//it***************** 

//Definition du tableau 

$tabind=array("Bl anc2" , "Jaune" , "rouge" , "Vert" , "Bleu" ,"Noi r" , "BlanclO" , "1ZZ" ,"2AA") ; 

$copie= Stabind; 

echo "<b>Tableau indice d'origine</b><br />"; 

print_r($tabind) ; 

//******************************** 

echo "<hr />Tri en ordre naturel avec sauvegarde des indices<br />"; 
$tabind=$copie; 
natsort(Stabind) ; 
print_r($tabind) ; 
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//******************************** 

echo "<hr />Tri en ordre naturel insensible a la casse avec sauvegarde des indices 

*<br />"; 

$tabind=$copie; 

natcasesort($tabind) ; 

print_r($tabind) ; 

foreach (Stabind as $cle=>$val) 

{ 

echo "$cle => $val <br />" ; 

} 

?> 

Les resultats des tris sont les suivants : 

Tableau indice d'origine 

Array ( [0] => Blanc2 [1] => Jaune [2] => rouge [3] => Vert [4] => Bleu [5] => Noir [6] 

=> BlanclO [7] => 1ZZ [8] => 2AA ) 

Tri en ordre naturel avec sauvegarde des indices 

Array ( [7] => 1ZZ [8] => 2AA [0] => Blanc2 [6] => BlanclO [4] => Bleu [1] => Jaune [5] 

=> Noir [3] => Vert [2] => rouge ) 

Tri en ordre naturel insensible a la casse avec sauvegarde des indices 

Array ( [7] => 1ZZ [8] => 2AA [0] => Blanc2 [6] => BlanclO [4] => Bleu [1] => Jaune [5] 

=> Noir [2] => rouge [3] => Vert ) 

Trier selon un critere personnel 

Si les fonctions de tri precedentes ne nous conviennent pas, vous pouvez definir vous- 
meme un critere de tri. II vous suffit pour cela de creer une fonction de comparaison. 
Cette derniere effectue un test contenant un operateur impliquant une relation d'ordre sur 
les valeurs des elements. 



Pour en savoir plus 

Pour savoir comment definir une fonction personnalisee, reportez-vous au chapitre 7. 



La fonction doit retourner une valeur entiere positive, negative ou nulle selon le resultat 
du test. Vous choisirez generalement les valeurs 1, -1 et 0, mais vous pourriez tout aussi 
bien choisir N, -N et 0). Le tri s'effectue dans les conditions suivantes : 

• Si le test est evalue a TRUE et que la fonction retourne un nombre negatif, les elements 
sont tries dans l'ordre defini par le critere du test. 

• Si le test est evalue a TRUE et que la fonction retourne un nombre positif, les elements 
sont tries dans l'ordre inverse de celui defini par le critere du test. 

• Si le test est evalue a TRUE et que la fonction retourne 0, les elements sont de meme 
rang dans l'ordre du test. 
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Dans l'exemple 5-20, la fonction de test longO, dont le code figure ci-dessous, compare 
la longueur des chaines de caracteres a l'aide de la fonction strl en( ). Si la chaine conte- 
nue dans $motl est plus longue que celle contenue dans $mot2, la fonction retourne -1, et 
$motl est place avant $mot2. 

function long($motl,$mot2) 
{ 

if(strlen($motl)>strlen($mot2)) return -1; 

elseif (strlen($motl)<strlen($mot2)) return 1; 

else return 0; 
} 

La fonction de tri utilisable pour les tableaux indices est la suivante : 

void usort($tab, "nom_fonction") 

Elle trie les valeurs des elements de Stab selon le critere defini dans la fonction dont le 
nom est passe en second parametre. Les associations entre les indices ou les cles du 
tableau et les valeurs ne sont pas sauvegardees. La fonction ne retourne aucune valeur et 
agit sur le tableau initial, lequel est done perdu. 

Le listing de l'exemple 5-20 definit une fonction de tri selon la longueur des chaines, 
utilise la fonction usort( ) et affiche le tableau trie. 

Exemple 5-20. Tri personnalise 

<?php 

//TRI SUR UN CRITERE PERSONNALISE 

//Definition de la fonction de tri 

function long($motl,$mot2) 

{ 

if(strlen($motl)==strlen($mot2)) return 0; 

elseif(strlen($motl)>strlen($mot2)) return -1; 

else return 1; 
} 

//Tableau a trier 

$tab=array("Bl anc" , "Jaune" , "rouge" , "Vert" , "Orange" , "Noir" , "Emeraude" ) ; 
//Utilisation de la fonction de tri 

echo "Tri selon la longueur des chaines de caracteres<br>" ; 
echo "Tableau initiaKbr />"; 
print_r($tab) ; 
usort($tab,"long" ) ; 

echo "<br />Tableau trie selon la longueur croissante des mots<br />"; 
print_r($tab); 
?> 

Nous obtenons le resultat suivant : 
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Tri selon la longueur des chaines de caracteres 

Tableau initial 

Array ( [0] => Blanc [1] => Jaune [2] => rouge [3] => Vert [4] => Orange [5] => 

Noir [6] => Emeraude ) 

Tableau trie selon la longueur decroissante des mots 

Array ( [0] => Emeraude [1] => Orange [2] => Blanc [3] => rouge [4] => Jaune [5] => 

Vert [6] => Noir ) 

Melanger les valeurs de fagon aleatoire 

Certaines applications gerent des nombres aleatoires, pour des tirages au sort, par exem- 
ple. D'autres affichent des informations dans un ordre different pour chaque visiteur. 
Dans tous ces cas, vous pouvez utiliser un tableau contenant les informations a afficher et 
melanger ces elements de maniere aleatoire au moyen de la fonction shuffl e( ), dont la 
syntaxe est la suivante : 

void shuffle(array $tab) 

Cette fonction modifie le tableau Stab, dont les valeurs des elements sont melangees de 
facon aleatoire. La encore, le tableau initial est perdu. 

II est recommande d'initialiser le generateur de nombres aleatoires de PHP en appelant la 
fonction srand( ) avec un parametre entier avant son utilisation. Les associations des indi- 
ces et des valeurs ne sont pas sauvegardees. 

Exemple 5-21. Melange aleatoire des elements 

<?php 

//Creation du tableau de nombres 

$tab = ranged, 10); 

echo "<h4> Tableau initial </h4>" ; 

print_r($tab) ; 

echo "<h4> Melange en ordre aleatoi re</h4>" ; 

//Initialisation du generateur de nombres aleatoires 

srand(time( )) ; 

//Melange des elements puis affichage du tableau 

shuffl e($tab); 

print_r($tab) ; 

?> 

Le listing affiche le resultat suivant : 

Tableau initial 

Array ( [0] => 1 [1] => 2 [2] => 3 [3] => 4 [4] => 5 [5] => 6 [6] => 7 [7] => 8 [8] => 

9 [9] => 10 ) 

Melange en ordre aleatoire 

Array ( [0] => 4 [1] => 7 [2] => 5 [3] => 6 [4] => 8 [5] => 10 [6] => 1 [7] => 3 [8] => 

9 [9] => 2 ) 
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Le melange etant aleatoire, vous avez evidemment peu de chance de retrouver le meme si 
vous testez le script, le parametre passe a srandO etant l'instant present en secondes 
fourni par la fonction time( ). 

Trier des tableaux associatifs 

Les fonctions que vous venez d'etudier pourraient s'appliquer egalement aux tableaux 
associatifs, mais elles ont 1' inconvenient de ne pas conserver les associations entre les 
cles et les valeurs, ce qui, pour ce genre de tableau, est redhibitoire. Vous pourrez done 
trier soit les cles soit les valeurs. 

Trier des valeurs 

Les fonctions suivantes sont specialement dediees aux tableaux associatifs car elles 
preservent toutes les associations entre les cles et les valeurs : 

• void asort(array Stab). Trie les valeurs du tableau $tab selon l'ordre croissant des 
codes ASCII des caracteres qui les composent en preservant les associations cle- 
valeur. 

• void arsort(array $tab). Trie les valeurs du tableau Stab selon l'ordre decroissant des 
codes ASCII des caracteres qui les composent en preservant les associations cle- 
valeur. 

• void uasort(array Stab, string "nom_fonction"). Joue le meme role que la fonction 
usortO, deja presentee pour les tableaux indices, en effectuant un tri selon le critere 
defini dans la fonction de comparaison. Elle conserve en outre les cles associees aux 
valeurs. 

Les fonctions natsortO et natcasesort( ), qui permettent de trier les elements selon 
l'ordre naturel respectivement en tenant compte ou pas de la casse, sont egalement 
utilisables dans les tableaux associatifs car elles preservent les associations entre les cles 
et les valeurs. 



Exemple 5-22. Tri de tableaux associatifs 

<?php 

//TABLEAUX ASSOCIATIFS 

Stabass= array("white2"=>"Blanc2" ,"yel low"=>"Jaune" , " red "=>" rouge" , "green"=>"Vert" , 

+■" blue"=>"Bleu","black"=>"Noir","whitelO"=>"BlanclO"); 

Scopieass=Stabass ; 

echo "<h4>Tableau associatif d'origine</h4>" ; 

print_r(Stabass) ; 

echo " < h 4 > T r i en ordre alpha des valeurs avec sauvegarde des cles</h4>"; 

$tabass=Scopieass ; 

asort(Stabass) ; 

print_r(Stabass) ; 

echo " < h 4 > T r i en ordre alpha inverse avec sauvegarde des cles</h4>"; 

Stabass=Scopieass ; 
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arsort($tabass) ; 

print_r($tabass) ; 

echo "<h4>Tri en ordre naturel avec sauvegarde des cles</h4>"; 

$tabass=$copieass; 

natsort($tabass) ; 

print_r($tabass) ; 

echo "<h4>Tri en ordre naturel insensible a la casse avec sauvegarde des cles</h4>"; 

$tabass=$copieass; 

natcasesort($tabass) ; 

print_r($tabass) ; 

?> 



Le listing affiche le resultat suivant : 



Tableau associatif d'origine 

Array ( [white2] => Blanc2 [yellow] => Jaune [red] => rouge [green] => Vert [ blue] => 

Bleu [black] => Noir [whitelO] => BlanclO ) 

Tri en ordre ASCII des valeurs 

Array ( [whitelO] => BlanclO [white2] => Blanc2 [ blue] => Bleu [yellow] => Jaune 

[black] => Noir [green] => Vert [red] => rouge ) 

Tri en ordre ASCII inverse 

Array ( [red] => rouge [green] => Vert [black] => Noir [yellow] => Jaune [ blue] => 

Bleu [white2] => Blanc2 [whitelO] => BlanclO ) 

Tri en ordre naturel avec sauvegarde des cles 

Array ( [white2] => Blanc2 [whitelO] => BlanclO [ blue] => Bleu [yellow] => Jaune 

[black] => Noir [green] => Vert [red] => rouge ) 

Tri en ordre naturel insensible a la casse avec sauvegarde des cles 

Array ( [white2] => Blanc2 [whitelO] => BlanclO [ blue] => Bleu [yellow] => Jaune 

[black] => Noir [red] => rouge [green] => Vert ) 

Trier les cles 

La caracteristique des tableaux associatifs est d'utiliser une cle a la place d'un indice 
numerique. II peut des lors etre utile d'operer des tris non plus sur les valeurs mais sur les 
cles des elements pour afficher les resultats de differentes facons. 

La fonction suivante : 

boolean ksort(array $tab) 

trie les cles de $tab selon l'ordre croissant des codes ASCII des caracteres. Les associa- 
tions cle-valeur sont conservees. Cette fonction retourne une valeur booleenne indiquant 
si l'operation de tri a reussi ou non. 

La fonction suivante permet de trier les cles selon l'ordre decroissant des codes ASCII 
des caracteres : 

boolean krsorttarray $tab) 

Elle conserve egalement les associations cle-valeur et retourne une valeur booleenne 
indiquant si l'operation de tri a reussi ou non. 
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Comme pour les tableaux indices, la fonction suivante : 

void uksort(array $tab .string "nom_fonction") 

permet de trier les cles des elements de $tab selon le critere personnalise defini dans la 
fonction passee en second parametre. La fonction de tri doit retourner -1 ou 1 selon que 
le critere est verifie ou non ou en cas d'egalite dans les memes conditions que la fonc- 
tion usort( ) presentee precedemment. 

L'exemple 5-23 utilise ces fonctions. 
Exemple 5-23. Tri des cles 

<?php 

//TABLEAU ASSOCIATIF 

$tabass= array("white2"=>"Blanc2" ,"yel low"=>"Jaune" , " red" =>" rouge"" green "=>" Vert" , 

w-"blue"=>"Bleu","black"=>"Noir","whitelO"=>"BlanclO"); 

$copieass=$tabass ; 

echo "<h4>Tableau associatif d'origine</h4>" ; 

print_r($tabass) ; 

echo " < h 4 > T r i en ordre ASCII des cles</h4>"; 

$tabass=$copieass ; 

ksort($tabass) ; 

print_r($tabass) ; 

echo "<h4>Tri en ordre ASCII inverse des cles</h4>"; 

$tabass=$copieass; 

krsort(Stabass) ; 

print_r($tabass) ; 

//******************************** 

//TRI SUR UN CRITERE PERSONNALISE 
//******************************** 

function long($motl,$mot2) 
{ 



i 
e 
e 
} 

ech 
uks 
pri 
?> 



f(strlen($motl)>strlen($mot2)) return -1; 
lseif(strlen($motl)<strlen($mot2)) return 1; 
se return 0; 



o " < h 4 > T r i selon la 
ort($tabass, "long" ) ; 
nt_r($tabass) ; 



ongueur des cles </h4>" 



Le listing fournit les resultats ci-dessous, dans lesquels le tri des cles se fait selon 1' ordre 
ASCII et non pas naturel. C'est pour cette raison qu'il est preferable que les cles aient 
toutes la meme casse lors de la creation du tableau. 

II est possible de transformer la casse des cles avant le tri en appliquant au tableau la 
fonction array_change_key_case( ), dont la syntaxe est la suivante : 



array array_change_key_case (array Stab, int CTE) 



Les tableaux 

Chapitre 5 



Cette fonction transforme toutes les cles du tableau $tab en minuscules si la constante CTE 
vaut CASE_LOWER (valeur par defaut) ou en majuscules si elle vaut CASEJJPPER. 

Tableau associatif d'origine 

Array ( [white2] => Blanc2 [yellow] => Jaune [red] => rouge [green] => Vert [ blue] => 

Bleu [black] => Noir [whitelO] => BlanclO ) 

Tri en ordre alpha des cles 

Array ( [ blue] => Bleu [black] => Noir [green] => Vert [red] -> rouge [whitelO] => 

BlanclO [whlteZ] => Blanc2 [yellow] => Jaune ) 

Tri en ordre alpha inverse des cles 

Array ( [yellow] => Jaune [white2] => Blanc2 [whitelO] => BlanclO [red] => rouge 

[green] => Vert [black] => Noir [ blue] => Bleu ) 

Tri selon la longueur des cles 

Array ( [whitelO] => BlanclO [white2] => Blanc2 [yellow] => Jaune [black] => Noir 

[green] => Vert [ blue] => Bleu [red] => rouge ) 



Operer une selection des elements 

Lorsqu'un tableau contient un nombre important d' informations, vous pouvez realiser 
une selection de ses elements a l'aide de la fonction array_f i 1 ter( ) et ne retenir que ceux 
qui repondent a une condition particuliere definie par le programmeur. 

La syntaxe de la fonction array_f i 1 ter( ) est la suivante : 

array array_fil tertarray $tab, string "nom_fonction") 

Elle retourne un nouveau tableau ne contenant que les elements de $tab qui repondent a 
la condition definie dans la fonction dont le nom est passe en second parametre. Le 
tableau initial est conserve. 

L'exemple 5-24 utilise la fonction array_fi1ter() pour selectionner parmi les elements 
d'un tableau contenant des noms de villes celles dont 1' initiate est "P" ou "p". 

La fonction de selection doit avoir comme parametre une variable qui represente la 
valeur d'un element courant du tableau sur lequel s'effectue la selection et retourner cette 
variable si elle repond a la condition enoncee. 

; *~ Exemple 5-24. Selection dans un tableau 



<?php 

//Definition du tableau 

$villes=array("Paris","Perpignan" 

//Fonction de selection 

function init($ville) 



"Marseil le" 



pau 



"Nantes", "Lille"); 



if($ville[0]=="P" || $ville[0]=="p" ) 

{ 

return Sville; 

} 
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//Utilisation de array_fil ter( ) 
$select=array_filter($vil les, "init") ; 
print_r($select) ; 
?> 

Ce script retourne le tableau $sel ect, dont la structure est la suivante : 

Array ( [0] => Paris [1] => Perpignan [3] => pau ) 



Appliquer une fonction a un tableau 

Si vous souhaitez appliquer une meme operation ou fonction a l'ensemble des valeurs 
des elements d'un tableau, vous pouvez envisager d'effectuer une boucle for ou whi 1 e et 
d'appliquer la fonction a chacun des elements lus. Outre l'allongement du code qui en 
resulterait, cette methode presenterait 1' inconvenient de multiplier les appels a la fonc- 
tion de calcul et entrainerait une perte de temps. 

Une facon plus elegante et plus rapide de parvenir au meme resultat consiste a utiliser la 
fonction array^wal k( ), qui peut avoir deux syntaxes differentes selon le nombre de para- 
metres qui lui sont passes. 

Avec deux parametres la syntaxe de la fonction arrayjal k( ) est la suivante : 

int array_wal k($tab, "nom_fonction" ) 

La fonction dont vous precisez le nom est appliquee a toutes les valeurs des elements du 
tableau $tab, que ce dernier soit indice ou associatif. La fonction appliquee aux valeurs 
doit etre une fonction personnalisee et non une fonction native de PHP. Elle doit de surcroit 
avoir au moins deux parametres, le premier faisant reference a la valeur de l'element de 
tableau a traiter et le second a 1' indice ou la cle de cet element. 

Vous pouvez evidemment detourner 1' interdiction d'utilisation d'une fonction native en 
appelant celle-ci dans la fonction personnalisee. Le listing de l'exemple 5-25 utilise cette 
syntaxe pour afficher sous forme de tableau XHTML le tableau de valeurs de la fonction 
cos(?/x) appliquee a toutes les valeurs du tableau $tabx, lequel contient les valeurs entie- 
res de 1 a 10. 

La figure 5-5 donne le resultat de cet exemple. 

Avec trois parametres, la syntaxe de la fonction array_wal k( ) est la suivante : 

array array_wal k(array $tab, string "nom_fonction" .divers param) 

Elle permet d'utiliser la valeur du troisieme parametre param comme troisieme parametre 
de la fonction "nom_fonction". Vous pouvez de la sorte personnaliser l'affichage, comme 
dans le deuxieme exemple du listing de l'exemple 5-25, qui utilise ce parametre pour 
creer la couleur de fond des cellules de la colonne affichant le prix TTC. 
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Exemple 5-25. Application d'une fonction aux elements d'un tableau 

<?php 
//it******************************** 

//array_wal k( ) avec deux parametres 
//it******************************** 

$tabx= ranged, 10); 

function tabval ($val ,$ind) 

{ 

echo "<tr><tdXb>", $ind+l ,"</b></td><td>" .cos(m_pi /$val ) . "</tdX/tr>" ; 

} 

echo"<table border=\"3\"Xtr> 

<td> <h2>tableau de valeurs</h2> 

<table border=\"l\" > 

<thead><th> x </th><th> cos(pi/x)</thX/thead>" ; 

a rray_walk($tabx," tabval ") ; 

echo"</tableX/td> "; 

//********************************** 

//array_wal k( ) avec trois parametres 
//********************************** 

$prix=array("22"=>"5.50","32.50"=>"19.60","80.00"=>"19.60"); 

//fonction de calcul ht et ttc 

function taxe($taux,$prix,$col ) 

{ 

echo "<tr><td > $prix </td><td > $taux </td><td>" .$prix*($taux/100) . 

"</td><td style=\"background-color:$col \">" .$prix*d+$taux/100) . "</tdX/ tr>"; 

} 

echo"<td><h2>facture detail lee</h2> 

<table border=\"l\" > 

<thead><th> h.t</th><th> taux</th><th> t.v.a.</th><th> t.t.c. .</th></ thead>"; 

array_wal k($prix, "taxe" , "red") ; 

echo"</tdX/trX/tableX/table>"; 

?> 

PHP propose un autre type de fonction, la fonction array_reduce( ), non pas pour appli- 
quer une fonction a chacun des elements d'un tableau, comme precedemment, mais pour 
retourner un seul resultat a partir de l'ensemble des valeurs contenues dans le tableau. Cela 
peut permettre, par exemple, de calculer la somme ou le produit de l'ensemble des 
valeurs du tableau. 

La syntaxe de la fonction array_reduce( ) est la suivante : 

divers array_reduce(array $tab, string "nom_fonction"[ .divers param]) 

Comme le ferait une boucle for, elle applique de facon iterative la fonction dont le nom 
est passe en parametre a l'ensemble des valeurs du tableau $tab. Le troisieme parametre 
facultatif est considere comme etant la premiere valeur du tableau. C'est la valeur retour- 
nee par defaut si $tab est vide. 
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Tableau de valeurs d'une fonction 


Facture detaillee 


s cos(pi/x) 


|l ||-1 


2 6.1230317691119E-17 


3 0.5 


h.t taux t.v.a. t.t.c. 


4 O.707106-811S655 


22.00 5.50 1.21 23.21 


5 0.80901699437495 


32.50 19.60 6.37 38.87 


6 0.86602540378444 


80.00 19.60 15.68 95.68 


7 0.90096886790242 


319.00 19.6 62.524 381.524 


8 0.92387953251129 




9 0.93969262078591 


10 0.95105651629515 
1 




Termine 







Figure 5-5 

Application de fonctions a des tableaux de donnees 



Le code de l'exemple 5-26 illustre l'utilisation de cette fonction pour calculer d'abord le 
produit d'un nombre de valeurs entieres en l'appliquant au calcul de la factorielle d'un 
entier A^. 



Rappel 

La factorielle de N est notee N\. Elle est egale a 1 x 2 x 3 x... N. Voir a ce sujet la section « Les fonctions 
recursives » au chapitre 7. 



Le deuxieme exemple permet ensuite d'operer la concatenation repetee de toutes les 
chaines de caracteres contenues dans les elements d'un tableau. II utilise comme troi- 
sieme parametre la chaine de caracteres "Sal ut a", qui constituera les premiers mots de 
tous les resultats retournes, quel que soit le tableau. 

Exemple 5-26. La fonction array_reduce() 

<?php 

//Definition de la fonction produit 

function multi ($a,$b) 

{ 

if ($a==0) $a=l; 

return $a*$b; 
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//array_reduce avec deux parametres 

$n=10; 

$tabn= range(l,$n); 

$prod=array_reduce($tabn, "multi ") ; 

echo "<hr />Produit des elements - factorielle $n 

//Definition de la fonction de concatenation 

function concat($a ,$b) 



$a.=$b; 

return $a; 

} 

// array_reduce avec trois parametres 

$tabch= array( "messieurs "," Hulot", ' 

$chaine=array_reduce($tabch, "concat" , ' 

echo "<hr>Concatenation des elements 

?> 



$n! = ",$prod; 



et "," Tati") 
Salut a ") ; 

" ,$chaine; 



Le script de l'exemple 5-26 affiche les resultats suivants 



Produit des elements = factorielle 10 = 10! = 3628800 
Concatenation des elements : Salut a messieurs Hulot et Tati 



L'objet ArrayObject 

A l'instar de ASP.Net, PHP 5 introduit un objet predefini ArrayObject representant un 
tableau. II permet de creer des tableaux qui ne sont pas du type array mais object. Ces 
objets possedent des methodes qui permettent d'effectuer diverses operations. Si vous 
n'etes pas familiarise avec les notions d'objet et de methode reportez-vous au prealable 
au chapitre 9. 

Pour creer un objet tableau, utilisez le mot-cle new selon la syntaxe suivante : 

$objtab=new ArrayObject( ) ; 

qui appelle le constructeur de l'objet. Le tableau cree est alors vide. Pour lui affecter des 
elements au moment de sa creation, vous pouvez passer au constructeur un parametre qui 
est un tableau PHP classique de type array selon le modele suivant : 

|$tab = arrayt "Linux" , "Apache") ; 
$objtab = new arrayObject($tab) ; 

Le tableau passe en parametre au constructeur peut egalement etre un tableau associatif, 
selon le modele suivant (reperes © et © de l'exemple 5-27) : 

|$tab = arrayt 'a '=>"l_inux" , 'b'=>"Apache" ); <— © 
$objtab = new arrayObject($tab) ; <— © 

La methode append ( ) permet d'ajouter des elements au tableau un par un (reperes ©. © 
et ©). Sa syntaxe est la suivante : 

$objtab->append("PHP 5"); 
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L'element ajoute a l'indice immediatement superieur au dernier existant dans la tableau. 
Ici, l'element de valeur "PHP 5" aura l'indice car les indices precedents sont des chaines. 

La boucle foreach etant applicable aux objets, elle permet de lire l'ensemble des cles (ou 
des indices) et les valeurs associees contenues dans le tableau (repere 0). 

L'equivalent de la fonction count ( ) applicable au type array est la methode count ( ), qui 
permet de lire le nombre d'elements de l'objet tableau (repere 0). 

II est encore possible de recuperer les cles et les valeurs contenues dans l'objet dans un 
tableau associatif habituel de type array en appliquant la methode getArrayCopyO a 
l'objet (repere©). L'affichage de ce tableau avec la fonction print^rO (repere 0) 
confirme que la variable obtenue est du type non plus object mais array. Vous pourriez 
alors appliquer a cette variable une des fonctions applicables aux tableaux que vous avez 
vues dans les sections precedentes. 

Vous pouvez verifier l'existence d'un element d'indice ou de cle donne en utilisant la 
methode offsetExists( ), qui retourne TRUE si l'element existe et FALSE sinon (repere 0). 

Pour lire un element du tableau, connaissant son indice ou sa cle, vous utilisez la methode 
off setGet( ), dont la syntaxe est la suivante : 

echo $objtab->offsetGet(cle) ; 

Le parametre est un nombre ou une chaine de caracteres selon les cas (repere 0). 

Pour ajouter un element en precisant sa cle numerique ou alphabetique, vous devez appe- 
ler la methode off setSet( ), dont la syntaxe est la suivante : 

$objtab->offsetSet( cle, valeur) ; 

Le parametre cle est egalement un nombre ou une chaine de caracteres selon les cas 
(reperes ® et ©). L'affichage du tableau (repere 0) permet de controler l'insertion des 
elements. 

Vous pouvez enfin supprimer un element au moyen de la methode offsetUnset( ) en lui 
donnant comme parametre l'indice ou la cle de l'element a supprimer (repere ©). La 
aussi, vous affichez le tableau pour verifier la suppression de l'element (repere ©). 

Exemple 5-27. Creation et manipulation d'un objet ArrayObject 

<?php 

Stab = arrayt 'a'=>"Linux" , 'b'=>"Apache") ; <— © 

//Creation de l'objet ArrayObject 

Sobjtab =new ArrayObject(Stab) ; <— 

//Ajout de trois elements 

$objtab->append("PHP 5");<-0 

$objtab->append( "MySQL"); <^© 

$objtab->append("SQLite"); <— 

//Lecture des elements 

foreach($objtab as $cle=>$val ) <— 



{ 



echo "$cle : $val<br />"; 
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echo "<hr />"; 

//Affichage du nombre d'elements 

echo "Nombre d'elements = " ,$objtab->count( ) ; <— Q 

//Copie dans un tableau array 

$tab2=$objtab->getArrayCopy( ) ; <— © 

print_r($objtab2); <— Q 

echo "<hr />"; 

//Verification de 1'existence d'un element d'indice ou de cle donne 

$val='a' ; 

if($objtab->offsetExists($val )) <-© 

{ 

echo "L'element d'indice $val existe dans le tableau. "; 

echo "II a la valeur : " ,$objtab->offsetGet($val ) , "<br />";<MD 

} 

echo "<hr />"; 

//Ajout d'un element d'indice ou de cle donne 

$objtab->offsetSet(3,'SimpleXML') : <-© 

$objtab->offsetSet('c' , 'ArrayObject ' ) ; <^© 

print_r($objtab); <— © 

echo "<hr />"; 

//Suppression d'un element d'indice donne 

$objtab->offsetUnset(3); <— © 

print_r($objtab) ; <— © 

?> 

Cet exemple affiche les resultats suivants, qui illustrent les possibility's offertes par les 
methodes de l'objet ArrayObject. 



a 


Linux 


b 


Apache 
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1 


MySQL 


2 


SQLite 



Nombre d'elements = 5 

Array ( [a] => Linux [b] => Apache [0] => PHP 5 [1] => MySQL [2] => SQLite ) 

L'element d'indice a existe dans le tableau. II a la valeur :Linux 

ArrayObject Object ( [a] => Linux [b] => Apache [0] => PHP 5 [1] => MySQL [2] => SQLite 
[3] => SimpleXML [c] => ArrayObject ) 

ArrayObject Object ( [a] => Linux [b] => Apache [0] => PHP 5 [1] => MySQL [2] => SQLite 
[c] => ArrayObject ) 

Le nombre de methodes disponibles actuellement pour l'objet ArrayObject est assez 
limite, mais nul doute qu'il va progresser dans l'avenir, ce qui le rendra aussi riche de 
methodes que le type array dote de tres nombreuses fonctions specifiques. 
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Memo des fonctions 

Les tableaux, qu'ils soient indices, associatifs ou multidimensionnels, fournissent un 
type de donnee riche de possibilites pour le stockage d' informations. Pour bien utiliser 
ces tableaux, vous devez en avoir une bonne connaissance car vous les retrouverez dans 
tous les types de scripts. 

PHP fournit un grand nombre de fonctions natives permettant les operations les plus 
diverses, allant de la creation aux manipulations les plus variees. La encore, la connais- 
sance de ces possibilites est gage d'efficacite dans l'ecriture de scripts. 

array_change_key_case(array $tab, int cte) 

Modifie la casse des cles du tableau $tab. La constante CTE vaut CASEJJPPER pour les majuscules ou CASE_LOWER pour 
les minuscules. 

array_chunk(array $tab, int NB [, boolean CLE]) 

Scinde le tableau $tab en un tableau multidimensionnel dont chaque element est un tableau indice contenant NB 
elements de $tab. Le parametre CLE indique s'il taut conserver les indices initiaux (TRUE pouroui). 

array array_combine(array Stabcle, array $tabval ) 

Cree un tableau associatif dont les cles sont les elements de $tabcl e et les valeurs ceux des $tabval . 

array_count_val ues(array $tab) 

Compte le nombre d'occurrences de chaque valeur des elements de $tab et retourne un tableau dont les cles sont les 
valeurs du tableau $tab et les valeurs le nombre d'occurrences. 

array array_diff ( array $tabl, array $tab2 [, array $tabN]) 

Retourne un tableau qui est la difference ensembliste des tableaux $tabl et $tab2. II contient les elements de $tabl 
moins ceux qui sont communs aux deux tableaux. Vous pouvez generaliser avec N tableaux. 

array array_fil 1 (integer depart, int N, divers valeur) 

Retourne un tableau dont tous les elements d'indices compris entre depart et depart+N ont la valeur contenue dans le 
parametre valeur. 



array array_fil tertarray $tab, string nom_fonction) 

Supprime tous les elements de $tab pour lesquels la fonction de tri passee en deuxieme parametre retourne FALSE. 

array array_fl ip(array $tab) 

Retourne un tableau associatif qui a pour cles les valeurs des elements de $tab et pour valeurs les cles de Stab. 

array array_intersect_assoc ( array $tabl, array $tab2 [, array $tabN]) 

Retourne un tableau associatif contenant les elements ayant meme cle et meme valeur pour les tableaux $tabl, $tab2, 
..., StabN. 

array array_intersect ( array $tabl, array $tab2 [, array $tabN]) 

Retourne un tableau contenant les elements ayant la meme valeur dans les tableaux $tabl, $tab2, ..., $tabN. 

bool array_key_exists ( divers cle, array $tab) 

Retourne TRUE si la cle (ou I'indice) de valeur cle existe dans Stab. 
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array array_keys ( array $tab [, divers val]) 

Retourne un tableau contenant uniquement les cles de $tab. Si le parametre val est precise, le tableau retourne contient 
la position des cles ayant la valeur val . 

array array_map ( string nom_fonction, array $tabl [, array $tab2 $tabN]) 

Applique lafonction indiquee a tous les elements des tableaux $tabl, $tab2, ..., $tabN. 

array array_merge ( array $tabl, array $tab2 [, array $tabN]) 

Retourne un tableau rassemblant tous les elements des tableaux $tabl, ..., $tabN. Si les cles sont identiques, c'est celle 
du dernier tableau qui I'emporte. 

bool arrayjul tisort ( array $tabl [, ctel,cte2 [,... [, array $tabN,ctel,cte2]]] ) 

Trie plusieurs tableaux $tabl $tabN selon les criteres precises pour chacun d'eux par les constantes ctel et cte2. 

Ces constantes ont pour valeurs : 

ctel S0RT_ASC : tri en ordre croissant (par defaut) ou S0RT_DESC : tri en ordre decroissant. 

cte2 SORT_REGULAR : comparaison alphabetique ou SORT_NUMERIC : comparaison numerique ou SORT_STRING : 

comparaison des chaines. 

array array_pad ( array $tab, int N, divers val) 

Retourne un tableau contenant les elements de $tab auxquels sont ajoutes plusieurs fois la valeur val pour obtenir N 
elements au total. Si N > les elements sont ajoutes au debut sinon a la fin. 

divers array_pop ( array $tab) 

Supprime le dernier element de $tab et retourne sa valeur. 

int array_push ( array $tab, divers $varl[, divers $varN]) 

Ajoute les valeurs $varl $varN a la fin du tableau $tab et retourne lataille du nouveau tableau. 

divers array_rand ( array $tab [, int N]) 

Choisit N elements au hasard dans $tab et retourne un tableau contenant les cles des elements choisis. Si N vaut 1 la 
fonction retourne une chaine contenant sa cle. 

divers array_reduce ( array $tab, string nom_fonction [, int N]) 

Applique la fonction precisee a I'ensemble des elements de $tab et retourne une valeur unique calculee a partir de ces 
valeurs (par exemple, la somme de tous les elements). Si le parametre N est passe, il est inclus dans les calculs comme 
valeur initiale. 

array array_reverse ( array $tab [, bool cle]) 

Inverse I'ordre des elements du tableau. Preserve les cles si le parametre cl e vaut TRUE. 

mixed array_shift ( array Stab) 

Supprime le premier element du tableau et retourne cet element. 

array array_slice ( array $tab, int N [, int L]) 

Retourne un tableau contenant L elements extraits de $tab et dont le premier a I'indice N. 

array array_splice ( array $tab, int N [, int L [, array $tab2]]) 



Supprime L elements de $tab a partir de I'indice N et les remplace eventuellement par ceux du tableau $tab2. 
mixed array_sum ( array $tab) 
Retourne la somme des elements du tableau. 
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array array_unique ( array $tab) 

Elimine les doublons et retourne un nouveau tableau. 

int array_unshift ( array Stab, divers $varl [, divers SvarN]) 

Ajoute les valeurs contenues dans les variables $varl, ..., $varN a la fin du tableau et retourne le nombre d'elements 
ajoutes. 

array array_val ues ( array $tab) 

Retourne un tableau ne contenant que les valeurs du tableau associatif $tab. Cree des indices numeriques de a N. 

bool array_walk ( array $tab, string nom_fonction) 

Applique la fonction indiquee a tous les elements de $tab. Si la fonction a plusieurs parametres, les elements sont passes 
comme premier parametre. Retourne TRUE si I'operation est reussie et FALSE sinon. 

bool arsort ( array $tab ) 

Trie le tableau associatif Stab en ordre decroissant des valeurs et en preservant les cles. Retourne TRUE si I'operation est 
reussie et FALSE sinon. 

bool asort ( array $tab [, int sort_flags]) 

Tri le tableau associatif $tab en ordre croissant des valeurs et en preservant les cles. Retourne TRUE si I'operation est 
reussie et FALSE sinon. 

array compact ( divers $varl [.divers SvarN]) 

Cree un tableau dont les elements sont les valeurs des variables $varl $varN. Ces variables peuvent etre des 

tableaux. 

int count ( array Stab [, int COUNT_RECURSIVE] ) 

Retourne le nombre d'elements de $tab. Pourobtenir le nombre d'elements d'un tableau multidimensionnel, il faut utiliser 
le deuxieme parametre. 

mixed current ( array $tab) 

Retourne la valeur de I'element pointe par le pointeur du tableau. 

array each ( array $tab) 

Retourne la cle (ou I'indice) et la valeur de I'element en cours dans un tableau a quatre elements. Les elements d'indice 
et key contiennent la cle de I'element de $tab. Les elements 1 et val ue contiennent la valeur associee. 

divers end ( array array) 

Place le pointeur de tableau sur le dernier element et retourne sa valeur. 

int extract ( array $tab [, int N [, string prefixe]]) 

Cree des variables dont les noms sont les cles de Stab et les valeurs celles de ses elements. 

bool in_array ( divers val, array $tab [, bool type]) 

Retourne TRUE si la valeur val est presente dans le tableau $tab. Si le parametre type vaut TRUE les types de la valeur 
recherchee et de I'element doivent etre identiques. 

divers key ( array $tab) 

Retourne la cle de I'element actuellement pointe dans $tab. 
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bool krsort ( array $tab) 

Trie $tab selon les cles en ordre decroissant. Les associations cle/valeur sont preservees. 

bool ksort ( array $tab) 

Trie $tab selon les cles en ordre croissant. Les associations cle/valeur sont preservees. 

void list ( $varl $varN) 

Permet d'affecter une liste de variables avec les elements du tableau $tab. 

void natcasesort ( array Stab) 

Trie le tableau en ordre naturel sans tenir compte de la casse. 

divers next ( array $tab) 

Retourne I'element suivant de $tab ou FALSE en fin de tableau. 

mixed prev ( array $tab) 

Retourne I'element precedent de $tab ou FALSE en fin de tableau. 

array range ( int min, int max [, int pas]) 

Cree un tableau contenant une suite d'entiers incrementee de une unite par defaut, en commengant a la valeur mi n et en 
finissant a max. Le parametre eventuel ne modifie pas cet increment. 

mixed reset ( array $tab) 

Replace le pointeur de tableau sur le premier element et retourne cette valeur. 

bool rsort ( array $tab [, int sort_fl ags]) 

Trie les elements de $tab en ordre decroissant. 

void shuffle ( array Stab) 

Melange tous les elements du tableau au hasard. 

bool sort ( array Stab [, int sort_flags]) 

Trie les elements de Stab en ordre croissant. 

bool uasort ( array Stab, string nom_fonction) 

Trie les elements du tableau associatif Stab en fonction d'un critere de comparaison defini par la fonction personnalisee 
nom_fonction. Les cles sont preservees. 

bool uksort ( array Stab, string nom_fonction) 

Trie les cles de Stab en fonction d'un critere de comparaison defini par la fonction personnalisee nom_fonction. 

bool usort ( array Stab, string nom_fonction) 

Trie les elements de Stab en fonction d'un critere de comparaison defini par la fonction personnalisee nom_fonction. 
Les cles sont preservees. 
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Exercices 



Exercice 1 

Ecrivez un tableau multidimensionnel associatif dont les cles sont des noms de personne 
et les valeurs des tableaux indices contenant le prenom, la ville de residence et l'age de la 
personne. 

Exercice 2 

Ecrivez un tableau multidimensionnel associatif dont les cles sont des noms de personne 
et les valeurs des tableaux associatifs dont les cles sont le prenom, la ville de residence et 
l'age de la personne avec une serie de valeurs associees. 

Exercice 3 

Utilisez une boucle fo reach pour lire les tableaux des exercices 1 et 2. 

Exercice 4 

Utilisez une boucle whi 1 e pour lire les tableaux des exercices 1 et 2. 

Exercice 5 

Creez un tableau contenant une liste d'adresses de sites recommandes, puis creez un lien 
aleatoire vers le premier site de la liste apres avoir trie le tableau en ordre aleatoire. 

Exercice 6 

Creez un tableau d'entiers variant de 1 a 63 puis, a partir de celui-ci, un autre tableau de 
nombres variant de a 6.3. Creez ensuite un tableau associatif dont les cles X varient 
de a 6.3 et dont les valeurs sont sin(X). Affichez le tableau de valeurs dans un tableau 
XHTML. 

Exercice 7 

Creez un tableau contenant une liste d'adresses e-mail. Extrayez le nom de serveur de ces 
donnees, puis realisez des statistiques sur les occurrences de chaque fournisseur d'acces. 
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Les formulaires 



Les formulaires introduits dans le HTML depuis ses plus anciennes versions sont 
l'element essentiel qui permet l'interactivite entre un site et ses visiteurs. lis constituent 
pour cette raison la base de la creation de sites dynamiques. L'envoi d' informations du 
poste client vers le serveur via le protocole HTTP concerne aussi bien l'envoi des 
donnees personnelles d'un internaute qui souhaite passer une commande que le declen- 
chement d'une requete dans une base de donnees ou la creation de page dynamique en 
reponse a cette demande. 

Tout echange entre visiteur et serveur passe par un formulaire, dans lequel l'utilisateur 
peut saisir textes ou mots de passe, operer des choix grace a des boutons radio, des cases 
a cocher ou des listes de selection, voire envoyer ses propres fichiers depuis le poste 
client. II est done important d'en maitriser la creation a la fois avec XHTML 1.1, pour 
obtenir des formulaires presentables, et avec PHP, pour gerer les informations fournies 
par le formulaire au script cote serveur. 

Creation d'un formulaire HTML 

Avant toute chose, il faut creer la structure XHTML d'un formulaire. 

Pour etre conforme au XHTML 1.1, le document contenant le formulaire doit avoir la 
structure minimale suivante : 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 
<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Titre de la page</title> <^© 
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</head> 
<body> 

<form method="post" action="nomdefichier.php"> 
<fieldset> 
<legend>Titre du formulai re</legend> 

<!-- Corps du formulaire contenant les differentes composants--> 
</fieldset>^© 
</form> 
</body> 
</html> 

L'element <form> possede certains attributs obligatoires. D'autres sont utilises dans des 
circonstances particulieres en fonction des besoins. 

L'attribut action="nom_de_fichier.php" (repere O) est obligatoire. II designe le fichier 
qui va traiter, sur le serveur, les informations saisies dans le formulaire. II est recom- 
mande que ce fichier soit present dans le meme repertoire que celui contenant le formu- 
laire, mais ce n'est pas obligatoire. Si le fichier se trouve dans un autre dossier, voire sur 
un autre serveur, il faut utiliser une adresse absolue, en ecrivant, par exemple : 

action= "http://www.abcphp.com/dossier/nom_de_fichier.php" 

Dans le cadre de ce livre, il s'agira toujours d'un fichier PHP. II existe d'autres solutions 
sur des serveurs non-PHP, comme ASP.Net, qui est un concurrent de PHP. 

Pour que le fichier qui traite les donnees soit a coup sur celui qui contient le formulaire, 
vous pouvez utiliser la variable $_SERVER["PHP_SELF"], qui contient le nom du fichier en 
cours d'execution comme valeur de l'attribut action. Pour les versions anterieures a 
PHP 4.1, il fallait utiliser la variable $PHP_SELF. En cas de maintenance du code entrainant 
le changement du nom du fichier, il n'est pas necessaire de modifier la valeur de l'attribut 
action. 

Vous pouvez avoir, par exemple, le code suivant : 

<form method="post" action="<?= $_SERVER["PHP_SELF"] ?>"> 

L'attribut action="nom_de„fichier.php" peut aussi avoir la valeur "mail to:", qui provoque 
l'envoi des donnees vers une adresse e-mail, qu'il faut preciser a la suite du mot mai 1 to en 
ecrivant, par exemple : 

action="mail to: nom@abcphp.com" 

Cette methode ne peut servir qu'a envoyer des informations vers un mail mais pas vers 
une base de donnees. Comme elle ne permet pas de les traiter facilement, elle ne nous est 
pas tres utile en PHP. 

method="post | get" determine la methode d'envoi des donnees vers le serveur. La methode 
get, qui est la methode par defaut, presente 1' inconvenient d'ajouter les donnees du 
formulaire a 1' adresse URI du fichier qui les traite, ce qui les rend visibles par le visiteur. 
Cet inconvenient peut etre exploite pour passer des donnees a un script des son appel. 
De plus, il existe une limite a la longueur des URI et done a la quantite de donnees a 
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transmettre. Ces problemes ne se retrouvent pas avec la valeur post, que vous utiliserez 
dans la plupart des cas. 

name="chaine_de_caracteres" attribue un nom au formulaire. Cet attribut est surtout utilise 
pour acceder aux elements du formulaire via un script JavaScript. 

enctype="type_d'encodage" determine le type d'encodage des donnees transmises au 
serveur. Sa valeur par defaut, "application/x-www-form-url encoded", est utilisable dans la 
plupart des cas, a l'exception du transfert de fichiers du poste client vers le serveur, pour 
lequel elle doit etre "multi part/form-data". Si l'attribut action a la valeur "mail to:", 
l'attribut enctype a pour valeur "text/plain" ou "text/html", selon que le contenu est 
envoye a une adresse e-mail au format texte ou XHTML. 

L'element <fieldset> (repere ©) permet, a l'interieur d'un meme formulaire, de creer 
des blocs visuels contenus entre les balises <f i el dset> et </f i el dset> et done de structurer 
le formulaire en fonction des champs qu'il contient, ce qui ameliore la presentation. 
L'element <1 egend> contient le titre de chacun de ces blocs. A l'interieur de chaque bloc se 
trouvent les elements XHTML qui creent les champs visibles ou invisibles du formulaire. 

Les sections qui suivent rappellent les differents compos ants XHTML d'un formulaire et 
leurs roles respectifs. 

Lelement <input l> 

La balise unique O'nput /> permet de creer les composants classiques des formulaires 
que vous connaissez deja et dont les aspects et les roles sont tres differents. La differen- 
ciation de ces composants s'effectue simplement en definissant la valeur de leurs attributs, 
et notamment de l'attribut type. 

L'attribut name est obligatoire, car e'est lui qui permet d'identifier les champs cote 
serveur et ainsi de recuperer leur contenu. Les sections qui suivent detaillent les elements 
de type "text", "password", "checkbox", "radio", "submit", "reset", "file" et "hidden". 

L'element <input type="text" l> 

Cet element cree un champ de saisie de texte d'une seule ligne. En plus de l'attribut name, 
vous pouvez apporter des precisions supplementaires a l'aide des attributs suivants : 

• size="nombre". Determine la largeur de la zone en nombre de caracteres. 

• maxlength="nombre". Determine le nombre maximal de caracteres que l'utilisateur est 
autorise a saisir. 

• value="texte". Definit un texte par defaut tant que l'utilisateur ne l'a pas modifie. 
C'est cette valeur qui est transmise au serveur si l'internaute ne saisit aucun texte, 
comme dans l'exemple ci-dessous : 

<input type ="text" name="ville" size="30" maxlength="40" value="Votre ville"/> 
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L'aspect visuel de ce composant est illustre a la figure 6-1 (reperes O 0> © et ©)• 



L'attribut value 

Pour des raisons d'ergonomie, il est preferable que le texte par defaut defini a I'aide de l'attribut val ue 
s'efface tout seul au moment ou I'utilisateur clique dessus car cela lui evite de devoir I'effacer. 
II suffit pour cela d'utiliser une instruction JavaScript tres simple : 
Pour reagir a I'evenement die : 

<input type ="text" name="ville" size="30" maxlength="40" value="Votre ville" 
oncl ick="this. valuer' ' "/> 

Pour que le texte s'efface des que la zone de texte regoit le focus (le curseur passe dans la zone) : 

<input type ="text" name="ville" size="30" maxlength="40" val ue="Votre ville" 
onfocus="this. value=' ' "/> 



L'element <input type=" password" l> 

Cree un champ de saisie de mot de passe semblable a un champ texte mais dans lequel les 
caracteres saisis sont invisibles et remplaces par des asterisques. 

Les attributs size et maxlength y jouent le meme role que precedemment. 

En voici un exemple : 

<input type ^"password" name="code" size="10" maxlength="6"/> 

L'element <input type="checkbox" l> 

Cree une case a cocher utilisee pour effectuer un ou plusieurs choix parmi ceux qui sont 
preetablis par le programmeur. L'attribut value contient le texte qui sera transmis au 
serveur si I'utilisateur coche la case. II est obligatoire. 

Dans les groupes de cases a cocher, il est possible de cocher plusieurs cases simultane- 
ment, ce qui n'est pas le cas des cases d'option (boutons radio). Dans ce cas, il faut que 
le nom de tous les composants soit le meme et qu'il soit suivi de crochets ouvrants et 
fermants de facon a recuperer les valeurs dans un tableau, comme vous le verrez en detail 
par la suite. 



En voici un exemple 

I 

L'aspect visuel de ce composant est illustre a la figure 6-1 (repere Q). 



<input type ^"checkbox" name="lang[]" value="francais" /> 
<input type ^"checkbox" name="lang[]" val ue="angl ais" /> 



L'element <input type="radio" l> 

Cree un bouton radio. Employe seul, un bouton radio peut servir a valider des choix. 
Employe en groupe, il implique, a la difference de cases a cocher, qu'un seul choix est 
autorise. Dans ce cas, tous les boutons radio du groupe doivent avoir une meme valeur 
pour l'attribut "name". Le fait d'en activer un desactive celui qui l'etait auparavant. 
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L'attribut checked="checked" definit le bouton coche par defaut. L'attribut value joue le 
meme role que pour les cases a cocher et est egalement indispensable. 



Voici un exemple d'utilisation de l'element "radio 

I 

L'aspect visuel de ce composant est illustre a la figure 6-1 (repere ©). 



<label>Debutant</label><input type ="radio" name="capa" value="debutant" /> 
<label>Initie</labe!Xinput type ="radio" name="capa" val ue="initie" /> 



L'element <input type="submit" l> 

Cree un bouton sur lequel l'utilisateur doit cliquer pour declencher l'envoi des donnees 
de tout le formulaire vers le serveur. 

II est indispensable d' avoir au moins un bouton d'envoi par formulaire, mais il est possible 
d'en utiliser plusieurs. Le clic sur l'un de ces boutons est alors analyse par le script desi- 
gne par l'attribut action de l'element <form>. Cela permet d'effectuer des taches speciali- 
sees en fonction de la valeur associee a chaque bouton grace a son attribut val ue. C'est le 
contenu de l'attribut val ue qui constitue le texte visible du bouton dans le formulaire. 

Vous pourrez voir des exemples d'utilisation de plusieurs boutons d'envoi a la fin de ce 
chapitre ainsi qu'au chapitre 13. L'attribut name n' 'est a priori pas utile, en particulier s'il 
n'y a qu'un seul bouton d'envoi. 

Voici un exemple simple d'utilisation de l'element "submit" : 

<input type ="submit" value="Envoyer" /> 

L'aspect visuel de ce composant est illustre a la figure 6-1 (repere ©). 

L'element <input type="reset" l> 

Cree un bouton de reinitialisation du formulaire et non d'effacement systematique, 
comme on le croit souvent. Si les elements du formulaire ont des attributs value qui 
definissent des valeurs par defaut, ce sont ces valeurs qui apparaissent au demarrage de la 
page et qui sont reaffichees si l'utilisateur clique sur le bouton reset. 

Le contenu de l'attribut val ue du bouton d'effacement constitue le texte visible du bouton 
dans le formulaire. 

En voici un exemple : 

<input type ="reset" val ue="Effacer" /> 
L'aspect visuel de ce composant est illustre a la figure 6-1 (repere ©). 

L'element <input type="file" l> 

Permet le transfert de fichiers du poste client vers le serveur. Cet element cree un champ 
de saisie de meme aspect qu'un champ de texte et un bouton de selection de fichier 
permettant a l'utilisateur de choisir le fichier a transferer. 
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L'attribut name est obligatoire. Vous pouvez utiliser en plus les attributs size limitant la 
taille de la zone de saisie, et plus particulierement l'attribut accept, qui definit le ou les 
types de fichier acceptes en transfert. Par securite, l'utilisation de cet attribut est recom- 
mandee car il permet de limiter le transfert a certains types de fichiers bien precis et de 
refuser les autres. 

Dans l'exemple ci-dessous, le serveur n'accepte que le transfert de fichiers ayant les 
extensions . gif ou . jpeg et refuse tout autre type : 

| <input type="file" name="monfichier" accept="image/gif ,image/jpeg" size="30"/> 

L'aspect visuel de ce composant est illustre a la figure 6-1 (repere ©). 

L'element <input type="hidden" l> 

Cree un champ cache n' ayant, comme son nom l'indique, aucun rendu visuel dans le 
formulaire mais permettant de transmettre des informations invisibles pour l'utilisateur. 

Les informations sont contenues dans l'attribut val ue. L'attribut name est obligatoire. 

En voici un exemple : 

<input type="hidden" name="MAX_FILE_SIZE" val ue="20000"/> 

Lelement <textarea> 

A l'instar de l'element O'nput /> avec l'attribut type=text, l'element <textarea> cree un 
champ de saisie de texte mais, contrairement au precedent, en permettant la saisie sur 
plusieurs lignes. 

Cet element comporte une balise de fermeture </textarea> et un contenu de texte par 
defaut affiche dans la zone de texte. Les attributs col s et rows, qui donnent respectivement 
le nombre de colonnes et de lignes de la zone de texte, doivent etre definis. 

L'exemple suivant : 

|<textarea name="commentai re" cols="45" rows="8" > 
Tapez vos commentaires ici 
</textarea> 

cree une zone de saisie de texte de 45 colonnes et 8 lignes au maximum. 

L'aspect visuel de ce composant est illustre a la figure 6-1 (repere ©). 

Lelement <select> 

Cree une liste de selection d' options parmi lesquelles l'utilisateur fait un choix, chaque 
option devant etre definie par un element <opti on> separe. 

L'element <select> a la structure suivante : 

<select name="maliste"> 
<option val ue="valeur 1"> Texte choix K/option> 
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I<opti on val ue="valeur 2"> Texte choix 2</option> 
<option val ue="valeur 3"> Texte choix 3</option> 
</select> 

II comporte les attributs suivants : 

• name="nom_sel ect". Obligatoire. Donne le nom de la liste. 

• size="Nombre". Determine le nombre de choix visibles simultanement. Par defaut, sa 
valeur est 1 . 

• mul ti pi e="mul ti pie". Autorise la selection de plusieurs options simultanement. 
L'element <option> comporte les attributs suivants : 

• val ue="chai ne". Obligatoire. Definit la valeur transmise au serveur si l'option est selec- 
tionnee. 

• selected="selected". Definit l'option qui est selectionnee par defaut dans la liste si 
l'utilisateur ne fait pas de choix. 

L'aspect visuel de ce composant est illustre a la figure 6-1 (repere ©). 

Exemple de code <form> 

L'exemple6-1 fournit le code d'un formulaire contenant tous les elements possibles 
repartis en trois groupes : 

• saisie des donnees personnelles du visiteur et zones de texte « nom », « prenom » et 
« mail » (reperes Q et ©), champ de saisie de mot de passe (repere 0), boutons 
radio (repere ©) et de selection (repere ©) a quatre options ; 

• cases a cocher (repere Q ) et zone de texte multiligne (repere ©) ; 

• envoi d'un fichier du client vers le serveur (repere Q), champ cache contenant la taille 
maximale des fichiers transferables et boutons de reinitialisation (repere ©) et d' envoi 
(repere ©). 

'•^ Exemple 6-1 . Formulaire type 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Formulai re traite par PHP</title> 
<style type="text/css"> 

fieldset {border-width: 3px; border-style: double; border: #993300} 
</style> 
</head> 
<body> 
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"40" maxlength="256" 
size="40" 

maxlength="256" 



<form action="cible.php" method="post" enctype="application/x-www-form-urlencoded"> 
<!-- Premier groupe de composants--> 
<fieldset> 

<legend><b>Vos coordonnees</bX/legend> 

<label>Nom : </label><input type="text" name="nom" size= 

*value="votre nom" /Xbr /> <— O 

<label>Prenom : </label><input type="text" name="prenom" si 

*maxlength="256" value="votre prenom" /Xbr /> <— Q 

<label>Mail : </l abelXinput type="text" name="mail " size=" 

*»value="votre mail" /Xbr /> <— Q 

<label>Code : </label><input type="password" name="code" size="40" 

*maxlength="6" /> <br /><-© 

<input type="radio" name="sexe" val ue="homme" /> Homme<br /> <— Q 

<input type="radio" name="sexe" val ue="femme" /> Femme<br /> 

<select name="pays" size="l"><— Q 

<option val ue="France"> France</option> 

<option val ue="Belgique"> Bel gique</option> 

<option val ue="Suisse"> Suisse</option> 

<option val ue="Canada"> Canada</option> 

</select> 

<br /> 
</fieldset> 
<!-- Deuxieme groupe de composants--> 
<fieldset> 

<legendXb>Vos gouts</bX/legend> 
<input type="checkbox" name="pomme" val ue="pomme" 
<input type="checkbox" name="poire" value="poire 



/> Pommes<br /> <— © 
1 /> Poires<br /> 



<input type="checkbox" name="scoubidou" val ue="scoubidou" /> Scoubidous<br /> 
<textarea name="gouts" cols="50" rows="5" oncl ick="this.value=' ' "><— © 
Decrivez vos gouts en detail 
</textarea> 
<br /Xbr /> 
</fieldset> 
<!-- Troisieme groupe de composants--> 
<fieldset> 
<legendXb>Envoyez nous votre photo</bX/legend> 
<input type="file" name="fichier" accept="image/jpeg" /><— © 
<input type="hidden" name="MAX_FILE_SIZE" val ue="10000" /> 
<br /Xbr /> 

<input type="reset" val ue="Effacer" /> <— © 
   <input type="submit" val ue="Envoyer" /> 
<br /Xbr /> 
</fieldset> 
</form> 
</body> 
</html> 

La figure 6-1 fournit une image du formulaire que vous venez de creer avec les reperes 
correspondant au code XHTML. 
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Decrivez vos gouts en detail 
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= Envoyez nous votre photo = 


9 


|| Pareourir... | 
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m 11 



£} Temilne 



$ Internet 



Figure 6-1 

Formulaire type complet 



Fichier XHTML ou PHP ? 

Le fichier peut etre enregistre sans probleme avec I'extension .html ou .htm, car il ne contient aucun 
code PHP. C'est le fichier cibl e.php, donne comme valeur de I'attribut acti on de I'element <f orm>, qui 
traite les donnees du formulaire cote serveur. II n'est pas genant de I'enregistrer avec I'extension .php, 
meme s'il ne contient aucun code PHP. 



Recuperation des donnees du formulaire 

Maintenant que vous savez creer de beaux formulaires, vous allez voir comment recupe- 
rer les donnees entrees par l'utilisateur dans les differents champs du formulaire. 

Tout d'abord, que se passe-t-il lorsque l'utilisateur clique sur le bouton d'envoi ? Une 
requete HTTP est envoyee au serveur a destination du script designe par I'attribut acti on 
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de l'element <form>. La requete contient toutes les associations entre les noms des 
champs et leur valeur. Ces associations se trouvent dans l'en-tete HTTP si la methode 
POST est utilisee et dans l'URL s'il s'agit de la methode GET. 



Valeurs uniques 



Les valeurs uniques proviennent des champs de formulaire dans lesquels l'utilisateur ne 
peut entrer qu'une valeur, un texte par exemple, ou ne peut faire qu'un seul choix (bouton 
radio, liste de selection a choix unique). 

Depuis PHP 4. 1 , ces valeurs sont contenues sur le serveur dans des tableaux associatifs 
dits superglobaux appeles $„P0ST et $„GET, selon la methode choisie. Les cles de ces 
tableaux sont les noms associes aux champs par l'attribut name. 

Voyons tout de suite ce mecanisme a l'oeuvre avec un formulaire elementaire ne conte- 
nant qu'un seul champ de saisie de texte. Dans la suite de l'ouvrage, nous privilegions 
l'emploi de la methode post pour l'envoi des formulaires. Dans ce chapitre, en revanche, 
nous envisageons la methode get a titre informatif. 



W3C 

Le W3C, I'organisme de « normalisation » du Web, envisage de supprimer la valeur get pour l'attribut 
method des formulaires en HTML ou XHTML. 



Cas de la methode POST 

Dans le code de l'exemple 6-2, l'element <f orm> est ecrit de la facon suivante (repere Q) : 

action= "<?= $_SERVER["PHP_SELF"] ?> 

Cela designe le script lui-meme comme cible pour le traitement des donnees. 

Le code PHP proprement dit est le suivant (repere ©) : 

<?php 

if(isset($_POST["nom"]) && isset($_POST["niveau"] ) ) 

{ 

echo "<h2> Bonjour ". stripslashes($_POST["nom"] ) . " vous etes " .$_P0ST["ni veau"] . 

*•" en PHP</h2>"; 

} 

?> 

II controle d'abord l'existence des variables $_P0ST["nom"] et $_POST["niveau"], qui repre- 
sentent respectivement le texte saisi et la valeur associee a la case cochee de facon a 
n'afficher le message qu'apres l'envoi des donnees (repere ©). Sans ces precautions, le 
message s'afficherait meme en l'absence de saisie de donnees par le visiteur. Ces variables 
n'existent que si l'utilisateur a complete les champs et a clique sur le bouton d'envoi. 
Lorsqu'elles existent, elles sont utilisees pour creer un affichage de bienvenue, comme 
illustre a la figure 6-2. 
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La fonction stripslashesO est utilisee pour supprimer les caracteres d'echappement 
ajoutes automatiquement devant les caracteres speciaux eventuellement utilises dans les 
donnees saisies avant de les afficher dans la page. 

Exemple 6-2. Recuperation des valeurs dans un formulaire elementaire 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Formulai re traite par PHP</title> 
</head> 
<body> 

<form action^ "<?= $_SERVER["PHP_SELF"] ?>" method="post" 
^* enctype="appl ication/x-www-form-urlencoded"> <— O 
<fieldset> 
<legend><b>Infos</bX/legend> 
<div> 

Norn : <input type="text" name="nom" size="40" /> 

<br /> 

Debutant : <input type="radio" name="ni veau" value="debutant" /> 

Initie : <input type="radio" name="niveau" value="initie" /Xbr /> 

<input type="reset" val ue="Effacer" /> 

<input type="submit" val ue="Envoyer" /> 

</div> 

</fieldset> 

</form> 

<?php <^@ 

if(isset($_POST["nom"]) && isset($_POST["niveau"] ) ) <^© 

{ 

echo "<h2> Bonjour ". stripslashes($_POST["nom"] ) . " vous etes ". 

^»$_POST["niveau"]." en PHP</h2>"; 
} 

?> 

</body> 
</html> 



Apres avoir saisi « Jan Geelsen » dans le champ texte et coche la case « debutant », vous 
obtenez l'affichage illustre a la figure 6-2. Remarquez que les saisies ne sont plus visi- 
bles car la page a ete entierement reaffichee dans le navigateur ; pour conserver les 
donnees saisies dans le formulaire, consultez la section « Maintien de l'etat du formu- 
laire » plus loin dans ce chapitre. 
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Figure 6-2 

Formulaire elementaire et resultat 



Cas de la methode GET 

Avec la methode GET, vous recuperez les donnees du formulaire dans les variables $_GET 
["nom"] et $_GET["niveau"], comme ci-dessous : 

<?php 

if(isset($_GET["nom"]) && isset($_GET["niveau"] ) ) 
{ 

echo "<h2> Bonjour ". stripslashes ($_GET["nom"]) . " vous etes " .$_GET["niveau"] . 

*■" en PHP</h2>"; 
} 
?> 

Contrairement a ce qui se passe avec la methode POST, vous constatez que lors du clic sur 
le bouton d'envoi l'adresse de la page cible designee par l'attribut action est suivie par le 
caractere ? puis par le nom de chaque champ et la valeur qui y est associee. 

Par exemple, si le nom de l'utilisateur est « Jean-Rene d'Orleans » et que la case « debu- 
tant » soit cochee, le navigateur affiche l'adresse complete : 

Ihttp://localhost/php5/C6form/form6.3_get.php?nom=Jean-Ren£E9+d£920rUE9ans&niveau 
*=initUE9 

Les caracteres accentues « e » et l'apostrophe sont codes en hexadecimal respectivement 
par %E9 et %92. Les espaces sont remplacees par le signe +, et chaque paire nom=valeur est 
separee par le signe &. 

Dans les versions anterieures a PHP 4.1, les donnees etaient recuperables dans les varia- 
bles $HTTP_POST_VARS ou $HTTP_GET_VARS ou encore directement dans des variables globales 
portant le nom des champs du formulaire (la valeur de leur attribut name), soit ici $nom et 
Sniveau. Ces methodes sont a considerer comme obsoletes. 
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Pour simplifier la manipulation des valeurs issues du formulaire, vous pouvez recuperer 
chaque valeur dans des variables scalaires des le debut du script de traitement, comme 
ci-dessous : 

I$sonnom= $_P0ST["nom"] ; 
$sonniveau=$_POST[ "niveau"] ; 

puis les reutiliser sous cette forme par la suite. 

Maintien de I'etat du formulaire 

Lorsque le script contenant le formulaire est charge du traitement des donnees, l'ensem- 
ble de la page est reaffiche apres traitement, de meme que l'ensemble du formulaire. Le 
formulaire se retrouve alors dans son etat initial, et toutes les saisies effectuees sont effa- 
cees (voir figure 6-2). 
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Figure 6-3 

Maintien de V etat du formulaire 



En cas d'erreur de saisie sur un seul champ, l'utilisateur est oblige de recommencer 
l'ensemble de la saisie. S'il s'agit d'un long questionnaire, il y a de quoi s'impatienter. 
Pour eviter cela, il est utile de maintenir I'etat du formulaire apres traitement en reaffichant 
l'ensemble des saisies. Vous allez effectuer cette operation a partir du code de l'exemple 6-2 : 

• Pour la zone de saisie de texte dont l'attribut name a la valeur "nom", il suffit de definir 
l'attribut value avec la variable $_P0ST["nom"], non sans avoir au prealable controle 
1' existence de cette variable. Lors du premier affichage de la page, la zone est done 
vide ou contient le dernier nom saisi (repere Q). Le code PHP est done : 

<?php if(isset($_POST["nom"])) echo $_P0ST["nom"]?> 

• Pour les boutons radio dont l'attribut name a la valeur "niveau" et qui permettent le 
choix entre les valeurs "Debutant" et "Initie", il faut definir l'attribut checked du 
bouton choisi a la valeur "checked" en fonction de la valeur de la variable $_P0ST 
["niveau"] (repere @). Pour le premier bouton, le code PHP devient : 
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|<?php if(isset($_POST["niveau"]) && $_POST["niveau"]=="debutant" ) 
**echo "checked=\"checked\"" ?> 

Apres une saisie identique a celle de la figure 6-2, vous obtenez un ecran identique a 
celui de la figure 6-3, dans lequel toutes les donnees saisies sont encore visibles apres le 
traitement du formulaire. 



Exemple 6-3. Maintien de I'etat du formulaire 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtrnlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Formulaire traite par PHP</title> 
</head> 
<body> 

<form action^ "<?= $_SERVER["PHP_SELF"] ?>" method="post" 
**enctype="appl ication/x-www-form-url encoded "> 
<fieldset> 

<legend><b>Infos</bX/legend> 

Norn : <input type="text" name="nom" size="40" value="<?php if (isset($_POST["nom"]) ) 
*echo $_POST["nom"]?>"/><-0 
<br /> 

Debutant : <input type="radio" name="niveau" value="debutant" 
<?php if(isset($_POST["niveau"]) && $„POST["niveau"]=="debutant" ) 
*-echo "checked=\"checked\"" ?> /><— © 
Initie : <input type="radio" name="niveau" value="initie" 
<?php if(isset($_POST["niveau"]) && $_POST["niveau"]=="initie") 
**echo "checked=\"checked\"" ?>/><br /> 
<input type="reset" val ue="Ef facer" /> 
<input type="submit" value="Envoyer" /> 
</fieldset> 
</form> 
<?php 

if(isset($_POST["nom"]) && isset($_POST["niveau"] ) ) 
{ 

echo "<h2> Bonjour ". stripslashes($_POST["nom"]) . " vous etes " .$_POST["niveau"]. 

*" en PHP</h2>"; 
} 

?> 

</body> 
</html> 



Exemple pratique 

L'exemple 6-4 offre une illustration pratique d'utilisation de formulaire. II s'agit d'un 
site d'annonces immobilieres proposant un plan de financement aux visiteurs. 

L'application est constitute de deux fichiers, form4.html et form4.php. 
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Le fichier form4.html affiche le formulaire de saisie des donnees necessaires au calcul du 
pret (voir figure 6-4). II ne contient aucun code PHP et peut done etre enregistre avec 
l'extension .html. L'attribut action de l'element <form> (repere Q) designe le fichier 
form4.php, qui est charge du traitement des donnees et de l'affichage des resultats. 

Le fichier form4.php verifie d'abord l'existence des variables $_POST["capital "], $_ 
P0ST["taux"] et $_POST["duree"], toutes necessaires au calcul du pret. La variable $_ 
POST["assur"] est necessaire dans tous les cas. Elle a la valeur 1 puisque le bouton radio 
« OUI » est coche par defaut. $capital correspond au capital emprunte (repere ©). $taux 
designe le taux mensuel sous forme decimale. Si l'utilisateur saisit 6 pour le taux annuel, 
la variable $taux vaut 6/100/12, soit 0,005, ou 0,5 % par mois (repere ©). $duree est la 
duree en mois (repere©). $assur renvoie au montant de l'assurance mensuelle, soit 
0,035 % du capital emprunte. Cette variable prend la valeur si $_P0ST["assur"] vaut 
(repere ©). 

Vient ensuite le calcul de la mensualite selon la formule financiere suivante (repere Q) : 

$mens=($capital*$taux)/(l-pow((l+$taux),-$duree)) 

Le script affiche la mensualite hors assurance (repere Q) ainsi que le tableau d'amortis- 
sement contenant, entre autres, le capital restant du et les interets de chaque periode 
(repere ©). La figure 6-5 donne un exemple de resultat. 

Si le formulaire est incomplet, l'instruction header( )affiche a nouveau la page de saisie 
form4.html, obligeant l'utilisateur a effectuer une saisie complete (repere ©). 

Exemple 6-4. Calcul de pret bancaire 

Page de saisie des donnees (fichier form4.html) : 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Calcul de prets</title> 
</head> 
<body> 

<h3>Prets </h3> 

<form method="post" action="form4.php"> <— O 
<fieldset> 

<legend>Les caracteristiques de votre pret</legend> 
<table> 
<tr> 

<td>Montant</td> 

<td><input type="text" name="capital " /></td> 
</tr> 
<tr> 
<td>Taux</td> 
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<tdXinput type="text" name="taux" /></td> 

</tr> 

<tr> 

<td>Duree en annee</td> 

<td><input type="text" name="duree" /></td> 

</tr> 

<tr> 

<td>Assurance</td> 

<td>OUI : <input type="radio" name="assur" checked="checked" value="l" />  

^»NON<input type="radio" name="assur" value="0" /></td> 

</tr> 

<tr> 

<td><input type="reset" name="" val ue="Effacer"/X/td> 

<tdXinput type=" submit" name="" value="Calculer"/X/td> 

</tr> 

</table> 

</fieldset> 

</form> 

</body> 

</html> 
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Figure 6-4 

Page principale de saisie des donnees 
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Page de traitement des donnees et d'affichage des resultats (fichier form4.php) 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtrnlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 
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<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<title>Tableau d'amortissement</title> 

</head> 

<body> 

<div> 

<?php 

if(isset($_POST["capital"])&&$_POST["taux"]&&$_POST["duree"]) 
{ 
$capital=$_POST["capital "]; <^© 
$taux=$_POST["taux"]/100/12; <-© 
$duree=$_P0ST["duree"]*12; <-© 
$assur=$_POST["assur"]*$capital*0. 00035; <— © 
$mens=($capital*$taux)/(l-pow((l+$taux) , -$duree)) ; <— © 
echo "<h3>Pour un pret de $capital € a ", $_P0ST["taux"] ,"%, sur ", 
*»$_P0ST["duree"] , " ans la mensual ite est de " ,round($mens,2) , " 
*»€ hors assurance</h3>" ; <— © 
echo "<h4>Tableau d'amortissement du pret</h4>"; 

echo "<table border=\"l\"> <tr><th>Mois </th><th>Capital restant</ th><th> 
w-Mensualite Hors Ass.</thXth>Amortissement </ th><th> Interet</thXth> 
**Assurance</thXth>Mensual ite Ass.cis </ th>";<— © 
//Boucle d'affichage des lignes du tableau 
for($i=l;$i<=$duree;$i++) 
{ 
$int=$capital*$taux; 
$amort=$mens-$int; 
echo "<tr>"; 
echo "<td>$i</td>"; 

echo "<td>" , round($capital ,2) , "</td>" ; 
echo "<td>",round($mens,2) ,"</td>" ; 
echo "<td>" , round($amort,2) , "</td>" ; 
echo "<td>",round($int,2),"</td>"; 
echo "<td>$assur</td>" ; 
echo "<td>" , round($mens+$assur,2) , "</td>" ; 
echo "</tr>"; 
$capital=$capital -$ amort; 
} 

echo "</table>"; 
} 

else 
{ 

header ("Locati on :form4.php") ; <— © 
} 

?> 

</div> 
</body> 
</html> 
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Figure 6-5 

Page d'qffichage des resultats 



Les valeurs multiples 

Certains champs de formulaire peuvent permettre aux visiteurs de saisir plusieurs valeurs 
sous un meme nom de composant. 

Cela peut concerner un groupe de cases a cocher ayant le meme attribut name, par exemple, 
dont il est possible de cocher une ou plusieurs cases simultanement. Ce peut egalement 
etre le cas d'une liste de selection ayant toujours un nom unique mais dans laquelle 
l'attribut multiple="multiple" est defini. II est enfin possible de donner le meme nom a 
des elements de saisie de texte differents, mais cela presente moins d'interet. 

Dans tous les cas, ce n'est pas une valeur scalaire mais un tableau qui est recupere cote 
serveur. II faut pour cela faire suivre le nom du composant de crochets, comme pour creer 
une variable de type array. 

Dans 1' exemple suivant : 

IB1 eu : <i nput type="checkbox" name="choix[]" val ue="bleu" /> 
Blanc:<input type="checkbox" name="choix[]" value="bl anc" /> 

l'utilisateur peut cocher les deux cases simultanement. Le programmeur recupere ces 
valeurs dans les variables suivantes : 

I$_POST["choix"][0] qui contient la valeur "bleu" 
$_POST["choix"][l] qui contient la valeur "blanc" 
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La variable $_P0ST est un tableau multidimensionnel, en l'occurrence a deux dimensions. 

L'exemple 6-5 illustre la methode de recuperation des valeurs multiples. Le formulaire 
cree par le fichier f orm5 . html contient trois zones de saisie de texte portant le meme nom, 
une liste de selection avec l'attribut mul ti pi e et quatre cases a cocher ayant le meme nom. 
Dans les listes de selection, l'utilisateur doit maintenir la touche Ctrl enfoncee pour faire 
plusieurs choix. II peut etre utile de lui rappeler cette fonctionnalite. 

L'objet du formulaire est de faire saisir une fiche de renseignements par l'utilisateur puis 
d'afficher 1' ensemble de ces informations. Le script cible du formulaire contenu dans le 
fichier form5.php recupere les donnees et realise une fiche recapitulative des renseigne- 
ments personnels si les variables du tableau $_P0ST existent (repere Q) ou, dans le cas 
contraire, une boite d'alerte, a l'aide de la fonction JavaScript alert( ) (repere @), et une 
redirection vers la page de saisie, via la fonction JavaScript window. history. backO 
(repere ©). 

La figure 6-6 illustre le formulaire de saisie et la figure 6-7 un exemple de fiche de resultat. 

Exemple 6-5. Recuperation des valeurs multiples 

Lefichierform5.html : 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Listes a choix multiples</title> 
</head> 
<body> 

<form method="post" action="form5.php" > 
<fieldset> 

<legend>Recherche d'emploi: completez la fiche </legend> 
<div> 

<span>Nom<input type="text" name="ident[]" /> 
PrenoirKinput type="text" name="ident[]" /> 
AgeO'nput type="text" name="ident[]" /> 
<br /Xbr /> 

Langues pratiquees<br /> 
<select name="l ang[]" multiple="mul tiple"> 
<option value="francais"> f rancais</option> 
<option value="anglais"> anglais</option> 
<option value="allemand"> al lemand</option> 
<option val ue="espagnol "> espagnol</option> 
</select><br /Xbr /> 
Competences informatiques<br /> 

XHTML<input type="checkbox" name="competent[]" val ue="XHTML" /> 
PHP<i nput type="checkbox" name="competent[]" value="PHP" /> 
MySQL<input type="checkbox" name="competent[]" val ue="MySQL" /> 
ASP.Net<input type="checkbox" name="competent[]" value="ASP.Net" /> 
</span><br /Xbr /> 
<input type="reset" val ue="EFFACER"/> 
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<input type=" submit" 

</div> 

</fieldset> 

</form> 

</body> 

</html> 



value="ENVOI"/> 
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Figure 6-6 

Formulaire de saisie 



Le fichier form5.php : 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtrnlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Competences Info</title> 
</head> 
<body> 
<?php 

if(isset($_POST["ident"]) && isset($_POST["l ang"] ) && 
*-isset($_POST[ "competent"])) <— Q 
{ 

echo "<table border=\"l\"XtrXth> Recapitul atif de votre fiche d' information 
*personnelle</thX/trXtrXtd>"; 
$nom-$_POST["idenf][0]j 
$prenom=$_POST["ident"][l]; 
$age=$_P0ST["ident"][2]; 
Slang = $_P0ST["1 ang"] ; 
$competent=$_POST[" competent"] ; 

echo"Vous etes :<b> $prenom ", stripslashes($nom) ,"</b><br />Vous avez 
*<b>$age ans </b> "; 
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echo "<br />Vous parlez :"; 

echo "<ul>"; 

foreach($lang as $valeur) 

{ 

echo " <li> $valeur </li>" ; 

} 

echo "</ul>"; 

echo "Vous avez des competences informatiques en :"; 

echo "<ul>"; 

foreach($competent as Svaleur) 

{ 

echo "<li> Svaleur </li> "; 
} 
echo "</ul> </td></tr>"; 



echo"<script type=\"text/javascript\">" ; 

echo "alert( 'Cochez au moins une competence! !');"; <— © 

echo "window. history .back( );" ; <— © 

echo "</script>"; 

} 

?> 

</body> 

</html> 
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Page de resultat 



3 http:Mocalhosf/php5C6form/form6.6a.php - Microsoft . (I~||n |!X 



Fichier Edition AFridhage Favoris OiAils ? 

£J Precedent* - y^J \*\ [^ ^ [ / . ' Rechercher '^favoris 



Aditsse \^l£\^;ff^<A*j>Lfrfv5l<:6tijinit\uiui5..fci,i.i\v 



^JS * 



Rfiajjituldlif Je vulie Jlche J ! iiiJij[ KL-aiiun jjciiuiuleILe 
Von?; fitps: .Ian (iKHI.SKN 
Vous avez 47 ans 

YoUS pailez . 

• franfais 

■ .■:-|-|.":i:' 

■ atlernand 

Vous avez; des competences nifjimatiqucs en : 

. XHTML 

• PHP 
« MySQL 



£ 



* J Intranet local 



PHP 5 



Transfert de fichier vers le serveur 

L' inclusion d'un element XHTML <input type="file" /> dans un formulaire cree une 
situation particuliere. II ne s'agit plus de transmettre une ou plusieurs valeurs scalaires au 
serveur mais l'integralite d'un fichier, lequel peut avoir une taille importante et un type 
quelconque. Ce fichier doit evidemment etre present sur l'ordinateur du visiteur. 

Par rapport au transfert de donnees, le transfert de fichiers presente un probleme de securite 
pour votre site puisque des fichiers vont etre ecrits et eventuellement executes sur le serveur. 

Supposez qu'un utilisateur mal intentionne transfere un fichier nomme index. php ou 
index.html sur le serveur. Ce fichier est execute automatiquement a l'appel de l'URL de 
votre nom de domaine. Pour eviter tout probleme, il est prudent de prevoir une verifica- 
tion de l'extension du fichier prealablement a la definition des extensions autorisees lors 
de la creation du formulaire. 

Pour cette definition, vous utilisez l'attribut accept de l'element O'nput />. Cet attribut 
peut prendre un grand nombre de valeurs, correspondant aux types MIME des fichiers 
acceptes, par exemple "image/gif", comme dans l'exemple 6-6, ou "text/html". Un 
fichier d'un type different est rejete, ce qui confere une protection contre les utilisateurs 
mal intentionnes. 

Contrairement aux exemples precedents, l'element <form> doit avoir l'attribut method a la 
valeur post et l'attribut enctype a la valeur multipart/form-data. 

Precaution supplementaire, vous pouvez envisager de limiter la taille des fichiers a tele- 
charger en ajoutant au formulaire un champ cache nomme MAX_FILE_SIZE, dont l'attribut 
value contienne la taille maximale admise en octet. Cette valeur est recuperee dans la 
variable $_POST["MAX_FILE_SIZE"] (repere ©) lorsque le champ cache est defini par le 
code suivant (repere Q) : 

<input type="hidden" name="MAX_FILE_SIZE" val ue="100000" /> 

L'utilisation de ce champ n'est pas obligatoire puisque le fichier php. i ni du serveur 
contient la directive "upl oad„max_f i 1 esi ze", dont la valeur est un entier indiquant la taille 
maximale en octet admise par defaut par le serveur. En local avec Wampserver, cette 
valeur est de 2 Mo. L'hebergeur peut toutefois definir une valeur tres differente, qu'il 
vous appartient de verifier a l'aide de la fonction phpinfo( ). 

L'ajout d'un bouton d' envoi a votre formulaire est bien stir toujours indispensable. 

Lors de l'affichage de la page, l'utilisateur se retrouve face a ce qui ressemble a une zone 
de saisie de texte accompagnee d'un bouton dont l'intitule est « Parcourir... ». II peut saisir 
manuellement 1' emplacement exact du fichier a transferer ou le choisir sur son disque en 
cliquant sur le bouton, comme il le ferait pour ouvrir un fichier a partir d'un traitement de 
texte, par exemple. II n'est done pas necessaire de lui expliquer la procedure en detail. 

Une fois le fichier selectionne, un clic sur le bouton Submit provoque 1' envoi du fichier 
au serveur et son traitement par un script, que vous devez encore ecrire. A ce moment, le 
fichier est bien transfere sur le serveur, mais il se trouve dans un repertoire tampon defini 
par la directive "upload_tmp_dir" du fichier php. n m". Si vous n'en faites rien, il est perdu 



Les formulaires 

Chapitre 6 

lors de la deconnexion du client. De plus, il est enregistre sous un nom different de celui 
qu'il avait sur le poste client, et vous ne savez pas encore sous quel nom, puisque celui-ci 
est cree arbitrairement par le serveur. 

De meme que pour le transfert de donnees simples, vous allez utiliser les tableaux super- 
globaux $_P0ST ou $_GET. Vous disposez egalement depuis la version PHP 4.1 du tableau 
associatif multidimensionnel $_FI LES, qui contient les informations necessaires au traite- 
ment du fichier transfere. 

Si, comme dans le code de l'exemple 6-6, le nom de l'element O'nput type="file". . /> 
est name="fich", vous pouvez lire les valeurs suivantes : 

$_FILES["fich"]["name"] : contient le nom qu'avait le fichier sur le poste client. 

$_FILES["fich"]["type"] : contient le type MIME initial du fichier et permet un 
controle et une censure eventuelle du fichier transfere. 

$_FILES["fich"]["size"] : donne la taille reelle en octet du fichier transfere. 

$_FILES["fich"]["tmp_name"] : donne le nom temporaire que le serveur attribue auto- 
matiquement au fichier en l'enregistrant dans le repertoire tampon. 

$_FILES["fich"]["error"] : donne le code d'erreur eventuel associe au fichier tele- 
charge et permet d'afficher un message d'erreur en clair en creant un tableau indice de 
a 4 contenant les messages appropries. Ces codes sont definis par les constantes 
entieres suivantes depuis PHP 4.3 : 

- UPL0AD_ERR_0K : de valeur 0, indique que le transfert est bien realise. 

- UPLOAD_ERR_INI_SIZE : de valeur 1, indique que la taille du fichier est superieure a 
celle definie dans la php . i n i . 

- UPLOAD_ERR_FORM_SIZE : de valeur 2, indique que la taille est superieure a celle definie 
dans le champ cache MAX_FILE_SIZE. 

- UPLOAD_ERR_PARTIAL : de valeur 3, indique que le fichier n'a ete que partiellement 
telecharge. 

- UPL0AD_ERR„N0_FI LE : de valeur 4, indique qu'aucun fichier n'a ete telecharge. 

En dernier lieu, vous devez proceder a l'enregistrement et au renommage eventuel du 
fichier sur le serveur. Vous disposez pour cela de la fonction move_uploaded_file(), dont 
la syntaxe est la suivante : 

boolean move_uploaded_file( string "fichtmp", string "fichfinal ") 

"fichtmp" est le chemin d'acces du fichier temporaire et "fichfinal " le nom sous lequel 
sera enregistre definitivement le fichier. La fonction retourne TRUE si l'operation est bien 
realisee et FALSE dans le cas contraire. 

Dans l'exemple 6-6, le code suivant (repere ©) : 

move_uploaded_file($_FILES["fich"]["tmp_name"] , "imagephp.gif") ; 

enregistre le fichier transfere designe par $_FI LES[ "f i ch" ] ["tmpjame" ] dans le repertoire du 
fichier form6.7.php du serveur sous le nom "imagephp.gif". Le fichier est alors pleinement 
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utilisable dans une page du site, comme si vous l'aviez transfere vous-meme a l'aide d'un 
logiciel FTP. 

Si le transfert est bien realise, vous affichez un message de bonne fin (repere ©). En cas 
de probleme de transmission ou de renommage du fichier, le script affiche le code de 
l'erreur generee a l'aide de la variable $_FILES["fich"][ "error"] (repere @). 

Exemple 6-6. Transfert de fichier 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Transfert de fichier</title> 
</head> 
<body> 

<form action="form6.php" method="post" enctype="multipart/form-data"> 
<fieldset> 

<input type="hidden" name="MAX_FILE_SIZE" val ue="100000" /> <^© 
<legend><b>Transfert de fichier</b></legend> 
<table> 
<tbody> 
<tr> 

<th>Fichier</th> 

<td> <input type="file" name="fich" accept="image/gif " size="50"/X/td> 
</tr> 
<tr> 

<th>Clic!</th> 

<td> <input type="submit" value="Envoi " /></td> 
</tr> 
</tbody> 
</table> 
</fieldset> 
</form> 

<!--Code PHP --> 
<?php 

if(isset($_FILES['fich'])) 
{ 

echo "Taille maximale autorisee : " ,$_POST["MAX_FILE_SIZE"] , 

*" octets<hr / >"; <-© 

echo "<b>Cles et valeurs du tableau \$_FILES </b><br />"; 
foreach($_FILES["fich"] as $cle => Svaleur) 
{ 

echo "cle : $cle valeur : Svaleur <br />"; 
} 

//Enregistrement et renommage du fichier 

$result=move_uploaded_file($_FILES["fich"]["tmp_name"] , "imagephp.gif" ) ; <— © 
if($result==TRUE) 

(echo "<hr /Xbig>Le transfert est realise !</big>" ; } <— Q 
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else 

{echo "<hr /> Erreur de transfert n" " ,$_FILES["fich"]["error"] ; } <— Q 
} 

?> 

</body> 
</html> 

La figure 6-8 illustre l'aspect de la page d'envoi des fichiers et la figure 6-9 celui de la 
page de confirmation affichant le resultat de l'operation de transfert et les cles et valeurs 
du tableau $„FILES. 



Figure 6-8 

Formulaire d'envoi defichier 



3 Tidiisfei l d« fiuhibi - MiuiusufL hiLtfiutf[ ExjjIui 


G0K 


Fichier Edticn Affichage Favoris Ourtils ? 




Q Precedente T Q J£] ^ f> Rechercher 


f?Favoris (^ Media i EH ~ 




Adrc55c 


,f£j hap ; ^locolhostftjhpS/COFairri/FoiTnO.? . php 


v 


H OK Liens 




















lirhier C:\EYRCiLLES\irnages\figurQgif.gif 


\ Parcourir... ] 








Clic 


! | Envoi 1 










-b] I ermine 


*J intranet local 



a Ti'dii-sfei l du Nuliitr - Miui usufl Iniei uul ExjjIui «r 



Fichier Ecttion Affichaqe Favoris Oun'ls ? 



Q Precedente T x] [s] i ,- Rechercher '" Favoris 



1: ht:p: i.'loc alhostfphps/Crjform foi ne 7.chp 



Transfert de fielder 
Fichier 



Parcourir... 



die! [ Envoi | 



Taille maxirf.ale autozisee : 100000 octets 



-llnira 



LjC* 



Cles et valeurs du tableau $_FJLES 

cle : name valour : figure gif gif 

cl£ : type valeur : irn^ge/gif 
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cle : error valeur : 

cle : size valeur : 24420 
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Figure 6-9 

Page de confirmation du transfert 
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Transfert de plusieurs fichiers 

II est possible de proposer a l'utilisateur de transferer plusieurs fichiers simultanement 
pour lui eviter de recommencer plusieurs fois la me me operation a partir de l'exemple 
precedent. Vous devez en ce cas faire en sorte que les elements <input type="file".../> 
soient tous ecrits de la maniere suivante : 

<input type="file" name="fich[]"accept="image/gif " size="50"/> 

avec le meme nom suivi de crochets (reperes Q et de l'exemple 6-7) ; l'attribut accept 
peut prendre des valeurs differentes pour chaque element <i nput />. 

La page de transfert correspondante est illustree a la figure 6-10. 
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Figure 6-10 

Formulaire de transfert de plusieurs fichiers 



Vous recuperez les informations sur les fichiers transferes dans la tableau $_FI LES, devenu 
multidimensionnel a trois dimensions. 

Par exemple, la variable suivante : 

$_FILES["fich"]["name"][0] 

permet de connaitre le nom du premier fichier transfere. 

Vous pouvez lire les caracteristiques de chacun des fichiers transferes a l'aide des 
boucles f oreach imbriquees (reperes © et 0). Ce code n'a toutefois d'interet que pour le 
programmeur lors des tests et est a supprimer dans un site reel. 

Vous procedez enfin au renommage et a la sauvegarde des fichiers transferes (reperes 
et Q) puis au controle du bon deroulement de l'ensemble des operations (repere Q). 
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Exemple 6-7. Transfert simultane de plusieurs fichiers 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Transfert de plusieurs fichiers</title> 
</head> 
<body> 

<!-- Code HTML du formulaire --> 

<form action="<?= $_SERVER[ ' PHP_SELF' ] ?>" method="post" 
*»enctype= "multipart /form-data" > 
<fieldset> 

<input type="hidden" name="MAX_FILE_SIZE" value="100000" /> 
<legend><b>Transferts de plusieurs fichiers</b></legend> 
<table> 
<tbody> 
<tr> 

<th>Fichier K/th> 

<td> <input type="file" name="fich[]" accept="image/gif " size="50"/X/td><— O 
</tr> 
<tr> 

<th>Fichier 2</th> 

<td> <input type="file" name="fich[]" accept="image/gif " size="50"/><— © 
</td> 
</tr> 
<tr> 

<th>Clic!</th> 

<td> <input type="submit" value="Envoi " /></td> 
</tr> 
</tbody> 
</table> 
</fieldset> 
</form> 

<!— Code PHP — > 
<?php 

if(!empty($_FILES)) 
{ 

echo "Taille maximale autorisee : " ,$_POST["MAX_FILE_SIZE"] , " octets<hr / >"; 

foreach($_FILES["fich"] as $cle => $valeur)<-© 

{ 
echo "CI e : $cle <br />"; 
foreach($valeur as $key=>$val ) <— © 
{ 

echo " Fichier : $key valeur : $val <br />"; 
} 

} 

//Depl acement et renommage des fichiers 

$resul tl=move_uploaded_file($_FILES["fich"]["tmp_name"][0], "imagel.gif ") ; <— © 
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$result2=move_uploaded_file($_FILES["fich"]["tmp_name"][l] ,"image2.gif") ; <— © 

if($resultl==true && $resul t2==true) <^Q 

{echo "<br /> Transferts realises !<br />";} 

else 

{echo "<br /> Transferts non effectues <br />";} 
} 

else echo "<h4>Choisissez les fichiers a transferer </h4>"; 
?> 

</body> 
</html> 

Les informations ecrites par les boucles f oreach ont l'aspect suivant en cas de reussite des 
transferts : 



Taille maximale autorisee : 100000 octets 



Cle : 
Fichi 
Fichi 
Cle : 
Fichi 
Fichi 
Cle : 
Fichi 
Fichi 
Cle : 
Fichi 
Fichi 
Cle : 
Fichi 
Fichi 



name 
er : 
er : 1 

type 
er : 
er : 1 

tmp_ni 
er : 
er : 1 

error 
er : 
er : 1 

size 
er : 
er : 1 



valeur : figuregif.gif 
valeur : figuregif2.gif 



valeur : image/gif 

valeur : image/gif 

me 

valeur : C:\D0CUME~2\PROPRI~l\LOCALS~l\Temp\php2B8C.tmp 

valeur : C:\D0CUME~2\PROPRI~l\LOCALS~l\Temp\php2B8D.tmp 

valeur : 

valeur : 



va leur 
valeur 



24420 
27614 



Transferts realises ! 



Gerer les boutons d'envoi multiples 

L'utilisation de plusieurs boutons submit dans un meme formulaire permet de declencher 
des actions differentes en fonction du bouton active par l'utilisateur. II est necessaire pour 
cela que les boutons aient le meme nom et que la selection de Taction se fasse en fonc- 
tion de la valeur associee a chaque bouton via l'attribut val ue. 

L'exemple 6-8 cree une calculatrice en ligne proposant les operations d' addition, de 
soustraction, de division et de puissance. II est evidemment possible d'ajouter autant 
d'operations que necessaire. A chaque operation est associe un bouton submit (reperes 
O et O) 

Deux zones de saisie de texte permettent d'entrer deux operandes. Dans cet exemple, 
vous utilisez le maintien de l'etat du formulaire de facon que ces derniers restent visibles 
lors de l'affichage du resultat (reperes et 0). 
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Le code PHP commence comme d'habitude par verifier l'existence des variables conte- 
nues dans le tableau $_P0ST en fonction de la valeur contenue dans la variable $_P0ST 
["calcul"] de l'attribut value des boutons Submit. Selon l'operation desiree, une 
instruction switch effectue le calcul approprie, dont le resultat est contenu dans la 
variable $resultat. Cette valeur est affichee dans le champ de text nomme result 
(repere Q). 

Exemple 6-8. Une calculatrice en ligne 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<title>Calculatrice en 1 igne</title> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l" /> 
</head> 
<body> 

<!--Code PHP — > 
<?php 

if(isset($_P0ST["calcul"])&&isset($_P0ST["nbl"])&&isset($_P0ST["nb2"])) 
{ 

switch($_POST["calcul"]) 

{ 

case "Addition x+y": 

$resultat= $_P0ST["nbl"]+$_P0ST["nb2"] ; 

break; 

case "Soustraction x-y": 

$resultat= $_P0ST["nbl"]-$_P0ST["nb2"] ; 

break; 

case "Division x/y": 

$resultat= $_P0ST["nbl"]/$_P0ST["nb2"] ; 

break; 

case "Puissance x A y": 

$resultat= pow($_POST["nbl"] ,$_P0ST["nb2"] ) ; 

break; 
} 
} 

else 
{ 

echo "<h3>Entrez deux nombres : </h3>"; 
} 

?> 

<!-- Code HTML du formulaire --> 

<form action="<?=$_SERVER['PHP_SELF']?>" method="post" > 
<fieldset> 

<legend><b>Calculatrice en 1 igne</b></legend> 
<table> 
<tbody> 
<tr> 
<th>Nombre X</th> 
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<td> <input type="text" name="nbl" value="<?php if (isset($_POST["nbl"]) ) 

'•echo $_POST['nbl'];else echo" ?>"/><-© 

</td> 

</tr> 

<tr> 

<th>Nombre Y</th> 
<td> <input type="text" name="nb2" val ue="<?php if (isset($_P0ST["nb2"]) ) 
• echo $_P0ST['nb2'];else echo" ?>"/><-© 
</td> 
</tr> 
<tr> 

<th>Resultat </th> 

<td> <input type="text" name="resul t" value="<?php if (issetdresultat)! 

• echo $resultat;else echo"?>"/><— Q 
</td> 
</tr> 
<tr> 

<th>Choisissez!</th> 

<td> 
<input type="submit" name= 
<input type="submit" name= 
<input type="submit" name= 
<input type="submit" name= 

</td> 
</tr> 
</tbody> 
</table> 
</fieldset> 
</form> 
</body> 
</html> 

La figure 6-11 illustre une page de resultat pour la fonction Puissance. 



calcul" value="Addition x+y" /><— O 
calcul" value="Soustraction x-y" /><— © 
value="Division x/y" /><— © 
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Une calculatrice en ligne 
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Exercices 



Exercice 1 

Creez un formulaire comprenant un groupe de champs ayant pour titre "Adresse cl lent". 
Le groupe doit permettre la saisie du nom, du prenom, de 1' adresse, de la ville et du code 
postal. Les donnees sont ensuite traitees par un fichier PHP separe recuperant les 
donnees et les affichant dans un tableau XHTML. 

Exercice 2 

Ameliorez le script precedent en verifiant 1' existence des donnees et en affichant une 
boite d'alerte JavaScript si l'une des donnees est manquante. 

Exercice 3 

Le fichier suivant peut-il etre enregistre avec 1' extension . php ou .html ? Ou se fait le 
traitement des donnees ? 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http: //www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<title> Insertion des donnees </title> 
</head> 
<body> 

<form method="post" action="ajout.php" > 
//Suite du formulaire 
</form> 
</body> 
</html> 

Exercice 4 

Comment faire en sorte que les donnees soient traitees par le meme fichier que celui qui 
contient le formulaire ? Proposez deux solutions. 

Exercice 5 

Creez un formulaire de saisie d' adresse e-mail contenant un champ cache destine a recu- 
perer le type du navigateur de l'utilisateur. Le code PHP affiche 1' adresse et le nom du 
navigateur dans la meme page apres verification de l'existence des donnees. 

Exercice 6 

Creez un formulaire demandant la saisie d'un prix HT et d'un taux de TVA. Le script 
affiche le montant de la TVA et le prix TTC dans deux zones de texte creees dynamique- 
ment. Le formulaire maintient les donnees saisies. 

Exercice 7 

Creez un formulaire n'effectuant que le transfert de fichiers ZIP et d'une taille limitee a 
1 Mo. Le script affiche le nom du fichier du poste client ainsi que la taille du fichier 
transfere et la confirmation de reception. 



PHP 5 



Exercice 8 

Dans la perspective de creation d'un site d'agence immobiliere, creez un formulaire 
comprenant trois boutons Submit nommes Vendre, Acheter et Louer. En fonction du 
choix effectue par le visiteur, redirigez-le vers une page specialisee dont le contenu 
reponde au critere choisi. 
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Les fonctions 



Une fonction est un bloc de code qui n'est pas execute de maniere lineaire dans un script. 
Ce code ne le sera que lors de l'appel explicite de la fonction. Ecrit une seule fois, ce code 
peut etre execute aussi souvent que necessaire. Cela allege d'autant l'ensemble du code. 



Les fonctions natives de PHP 

PHP propose en standard une multitude de fonctions natives ecrites en langage C, ainsi que 
quantite de modules d' extension qu'il est possible d'associer a la distribution standard. 
Les modules sont tous decrits dans la documentation officielle, et il est recommande 
d'utiliser les fonctions qu'ils contiennent plutot que de les reinventer vous-meme. 

Avant d'utiliser un module, il convient de verifier qu'il est bien installe sur le serveur de 
votre hebergeur. On recense aujourd'hui une bonne centaine d'extensions. Or je ne 
connais personnellement aucun hebergeur qui en ait installe ne serait-ce que la moitie, 
loin s'en faut. Pour verifier la disponibilite d'un module, vous disposez de la fonction 
get_loaded_extensions( ), qui retourne un tableau contenant les noms de tous les modules 
d' extension installes sur le serveur. 

En ecrivant le script suivant, vous obtenez la liste des modules classee par ordre alphabe- 
tique puis affichee a l'aide d'une boucle foreach : 

<?php 

$tabext = get_loaded_extensions( ) ; 
natcasesort($tabext) ; 
foreach($tabext as $cle=>$valeur) 



echo "  $valeur 



?> 
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Avec le serveur local Wampserver 2.0, vous obtenez la liste suivante : 



apache2handler 


bcmath 


calendar 


com_dotnet 


ctype 


date 


dom 


filter 


ftp 


gd 


hash 


iconv 


json 


1 i bxml 


mbstring 


mysql 


mysql i 


odbc 


pcre 


PDO 


pdo_mysql 


Reflection 


session 


SimpleXML 


SPL 


SQLite 


standard 


tokenizer 


wddx 


xmlxml reader 


xmlwriter 


zlib 
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bcmath 


calendar 


cgi 


ctype 


curl 


date 


dba 


dbase 


dom 


ex if 


filter 


ftp 


gd 


gettext 


gmp 


hash 




iconv 


imap 


json 


1 1 bxml 


mbstring 


mcrypt 


mhash 


ming 


mysql 


mysql i 


openssl 


pcre 


pdf 


PDO pdojnysql 


pdo_sql ite 


pgsql 


posix 


pspell 


Reflection 


session 


SimpleXML 


soap 


sockets 


SPL 


SQLite 


standard 


sysvsem 


sysvshm 


tokenizer 


wddx 


xml 


xml reader 


xml rpc 


xmlwriter 


xsl 


zip 


zlib 





Soit pas moins de 54 extensions ! 

Vous constatez qu'il existe peu d' extensions communes entre le serveur local installe 
avec Wampserver 2.0 et un serveur distant susceptible d'heberger votre site. 

Pour chaque module, il est possible de lister l'ensemble des fonctions disponibles. Cela 
n'est toutefois guere utile, car meme si une fonction fait partie d'un module, votre heber- 
geur peut tres bien l'avoir desactivee, notamment pour des raisons de securite ou d'abus 
d'occupation du serveur. La fonction mail ( ) d'envoi de courrier, par exemple, est souvent 
desactivee chez les hebergeurs, en particulier les gratuits. 

Pour obtenir la liste des fonctions d'un module, vous disposez de la fonction suivante : 

array get_extensions_funcs("nom_module") 

Cette fonction retourne un tableau indice, dont les valeurs sont les noms des fonctions de 
chaque module. 

Par curiosite, executez le petit script de l'exemple 7-1 sur votre serveur distant pour veri- 
fier la liste, classee par ordre alphabetique, des modules et des fonctions que vous pouvez 
utiliser. Quoi de plus frustrant, en effet, que d'ecrire de superbes scripts alors que les fonc- 
tions correspondantes sont disponibles sur le serveur local mais pas sur le serveur distant. 

Exemple 7-1 . Liste des modules et des fonctions affichees sur le serveur 
distant 

I<?ph P 
//Tableau contenant le nom des extensions 
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$tabext = get_loaded_extensions( ) ; 
natcasesort($tabext) ;//tri par ordre alphabetique 
//Lecture des extensions 
foreach($tabext as $cle=>$valeur) 
{ 

echo "<h3>Extension  $valeur </h3> "; 

//Tableau contenant le nom des fonctions 

$fonct = get_extension_funcs($valeur) ; 

//Tri alphabetique des noms de fonction 

sort($fonct) ; 

//Lecture et affichage du nom des fonctions des extensions 

for($i=0;$i<count($fonct);$i++) 

{ 
echo $fonct[$i ] , "    \n" ; 
echo "<hr />"; 

} 
) 
?> 

La figure 7-1 illustre la liste impressionnante de fonctions que vous obtenez. Par simple 
copier-coller, vous obtenez a bon marche un memo des fonctions utilisables sur votre 
serveur. 

Pour verifier la disponibilite d'une fonction native de PHP ou d'une fonction personna- 
lisee, vous pouvez tester sa presence a l'aide de la fonction function_exists("nom_ 
fonction"), qui renvoie la valeur TRUE si la fonction passee en parametre existe et FALSE 
dans le cas contraire. 

Pour verifier, par exemple, que la fonction mysql_pconnect() est utilisable, vous pouvez 
ecrire : 

if (function_exists( 'mysql_pconnect ' ) ) 
{ 

echo "La fonction est utilisable. <br />"; 



Creer ses propres fonctions 

Malgre les quelques deux mille fonctions contenues dans 1' ensemble des modules exis- 
tants a ce jour, il arrive, faute de fonction disponible, de devoir effectuer plusieurs fois le 
meme traitement dans un script. Heureusement, il est possible de creer des fonctions 
personnalisees, qui permettent tout a la fois de gagner du temps de saisie et d'alleger 
votre script en ne repetant pas plusieurs fois un meme code. 

Au fur et a mesure de l'ecriture de vos scripts, vous pouvez de la sorte reutiliser du code 
deja ecrit dans un script precedent. II vous faut pour cela identifier, des la conception du 
ou des sites que vous souhaitez realiser, les taches susceptibles de se retrouver dans 
d'autres situations et qui ne sont pas prises en compte par une fonction existante de PHP. 
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Figure 7-1 

Lwfe des fonctions disponibles sur le serveur de J'hebergeur ovh 

Ces fonctions personnalisees doivent etre ecrites dans un ou des scripts separes, qu'il vous 
suffit ensuite d'inclure dans de nouveaux scripts au moyen d'une instruction i ncl ude ( ) ou 

requi re( ). 



Def'mir une fonction 

En regie generale, une fonction peut etre definie n'importe ou dans un script, y compris 
apres avoir ete utilisee. II existe cependant des exceptions, rares, comme nous le verrons 
dans la section « Cas particuliers » en fin de chapitre. 

La procedure de declaration d'une fonction doit suivre les regies de syntaxe suivantes : 

• Commencez par definir l'en-tete de la fonction a l'aide du mot-cle function suivi du 
nom de la fonction et de parentheses. Les noms de fonctions suivent les regies enoncees 
pour les variables : caracteres alphabetiques et signe « _ » pour le premier caractere 
puis caracteres alphanumeriques pour la suite. II est deconseille de commencer un nom 
de fonction par deux caracteres de soulignement, car cette convention est reservee 
pour definir des fonctions natives de PHP 5. La redefinition de fonction etant interdite 
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dans PHP, contrairement a ce qui se fait dans d'autres langages, il est interdit de creer 
une fonction dont le nom soit identique a une fonction existante dans un des modules 
installes. En contrevenant a cette regie, vous vous exposez a une erreur fatale et au 
mechant message suivant, qui met fin au script : 



I* 



"Fatal error: Cannot redeclare dateO in c:\eyrolles\php5\fonctions\fonction2.php 
on line 3" 



Dans cet exemple, vous souhaitez definir une fonction nominee dateO au lieu de 
1 adate( ), comme a l'exemple 7-2, alors qu'il existe deja une fonction portant ce nom 
dans le module standard. 

• Les parentheses qui suivent le nom de la fonction peuvent contenir differents noms de 
variables comme parametres de la fonction. Les noms des parametres n'ont aucune 
importance en soi, et vous pouvez meme leur dormer des noms qui existent deja dans 
le script, quoique ce ne soit pas conseille. L'utilisation des parametres n'est pas obli- 
gatoire. 

• Ouvrez un bloc de code limite par des accolades contenant l'ensemble du code de 
definition de la fonction. Cette partie, qui constitue le corps de la fonction, peut conte- 
nir toutes les instructions de PHP ainsi que n'importe quelle fonction native. 

• Si la fonction doit retourner une valeur, ce qui n'est pas obligatoire, il faut faire prece- 
der la variable ou l'expression qui contient cette valeur du mot-cle return. 

Vous obtenez la structure generale suivante : 

function mafonction($x,$y , . . . ) 
{ 

//code de definition de la fonction 

return $var; 
} 

Pour appeler la fonction, vous ecrivez : 

mafonction($a,$b ) 

ou encore : 

mafonction(4,5, . . . ) 

Les parametres peuvent etre ici indifferemment des scalaires ou des variables. II importe 
dans les deux cas de donner a la fonction autant de parametres que dans sa declaration, 
sauf si vous avez defini des parametres par defaut (voir plus loin). 

La position de la declaration d'une fonction dans le script n'a pas d' importance depuis 
PHP 4. Vous pouvez ainsi appeler une fonction au debut du script alors qu'elle n'est defi- 
nie qu'en fin de script. II est toutefois preferable de definir les fonctions en debut de 
script, comme dans PHP 3, car cela ameliore la presentation et la lisibilite du code. 

Pour les fonctions definies dans des scripts separes, il est preferable de les inclure des le 
debut du script qui les utilise, et ce au moyen de l'instruction includeO ou requireO. 
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Les fonctions qui ne retournent pas de valeur 

Dans l'exemple 7-2, vous creez deux fonctions qui ne retournent pas de valeur. La 
premiere, 1 adateO, cree un affichage de la date et de l'heure sans aucun parametre, et la 
seconde 1 adate2 ( ) , y ajoute un message qui est passe en parametre unique. 

Ces deux fonctions creent un affichage dans une cellule de tableau XHTML munie d'un 
style particulier, qui peut etre le meme dans toutes les pages du meme site. 



Pour en savoir plus 

Pour plus de details sur la syntaxe de la fonction date( ) utilisee dans le script, reportez-vous au chapi- 
tre8. 



Lors des appels de ces fonctions, les trois premiers appels fonctionnent sans probleme. 
En revanche, l'appel de la fonction ladate2() sans parametre, alors meme que sa 
definition en comporte un, provoque un avertissement, ou "warning", mais sans mettre fin 
pour autant au script, a la difference d'une erreur fatale. Pour eviter ce genre de 
probleme, vous pouvez faire preceder, lors de son appel, le nom de la fonction par le 
caractere @, qui empeche 1' apparition du message d'alerte. 

La figure 7-2 illustre le resultat de ces differents appels. 



Exemple 7-2. Fonctions ne retournant pas de valeur 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtrnlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Fonctions ne retournant pas de valeurs</title> 
</head> 

<body> 
<div> 

<?php 

//Fonction sans argument 

function ladateO 

{ 

echo "<table XtrXtd style=\"background-color:blue;color:yellow; 

*» border -width: lOpx; border- styl e: groove; border-col or :#FFCC66; font-style: fantasy; 

*»font-size:30px\"> "; 

echo date("\l\e d/m/Y \i\l \e\s\\t H:i:s"); 

echo "</tdX/trX/table><hr />"; 
} 

//Fonction avec un argument 
function ladate2($a) 
( 
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echo "<table><tr><td style=\ "background-col or :bl ue;color:yel low;border-width:10px; 

*»border-style:groove;border-color:#FFCC66;font-style:fantasy ; font-si ze:30px\">" ; 

echo "$a ",date("\l\e d/m/Y \i\l \e\s\\t H:i:s"); 

echo "</tdX/trX/table><hr />"; 
} 

//Appels des fonctions 
echo ladateO; 
echo ladate2( "Bonjour" ) ; 
echo ladate2("Salut") ; 

echo ladate2( ) ;//provoque un avertissement (Warning) 
echo @ladate2( ) ;//empeche 1 'apparition du message d'avertissement 
?> 

</div> 
</body> 
</html> 
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Figure 7-2 

Fonctions d'affichage de la date 



Vous avez vu en detail au chapitre 5 la maniere de lire l'integralite d'un tableau. Si vous 
utilisez souvent ce tableau, vous avez tout interet a creer une fonction de lecture du 
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tableau et d'affichage de leurs elements sous la forme d'un tableau XHTML a deux 
colonnes par exemple. 

Cet exemple peut etre reutilise ou adapte pour afficher les resultats de 1' interrogation 
d'une base de donnees, lorsque les resultats sont recuperes sous forme de tableau, ce qui 
est souvent le cas. C'est l'objet de l'exemple 7-3, qui lit un tableau unidimensionnel. 

Les parametres de la fonction sont, dans l'ordre, le nom du tableau, la largeur de la 
bordure des cellules XHTML et les libelles des colonnes. Le corps de la fonction est 
essentiellement compose d'une boucle chargee de lire les cles et les valeurs des elements 
du tableau et ne presente pas de difficultes. Comme la premiere, cette fonction ne retourne 
pas de valeur mais cree un affichage XHTML. 

La figure 7-3 donne un exemple du resultat obtenu pour des tableaux de donnees. 
Exemple 7.3. Fonction de lecture de tableaux 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; =iso-8859-l" /> 
<title>Fonction de lecture de tableaux</title> 
</head> 

<body> 
<div> 

<?php 

//Definition de la fonction 

function tabuni ($tab,$bord,$libl,$l ib2) 

{ 

echo "<table border=\"$bord\" width=\"100%\"Xtbody><trXth>$l ibl</th> 

*<th>$lib2 </th></tr>"; 

foreach($tab as $cle=>$valeur) 

{ 
echo "<tr><td>$cle</td> <td>$valeur </tdX/tr>"; 

} 

echo "</tbody> </table><br />"; 
} 

//Definition des tableaux 

$tabl = a rray (" France "=>" Paris" , "Al lemagne"=>"Berl in" , "Espagne"=>"Madrid") ; 
$tab2 = array("Poisson"=>"Requin" ,"Cetace"=>" Dauphin" , "Oiseau"=>"Aigle" ) ; 
//Appels de la fonction 
tabuni ($tabl,l, "Pays" , "Capital e") ; 
tabuni ($tab2,6, "Genre" , "Espece") ; 
?> 

</div> 
</body> 
</html> 
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I Fonction de lecture de tableaux 
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Figure 7-3 

Affichages realises par la fonction tabuni() 



Les fonctions qui retournent une valeur 

Au sens mathematique du terme, une fonction se doit de retourner une valeur calculee a 
partir des parametres qui lui sont passes. Vous allez illustrer cette possibilite en creant 
une fonction qui calcule et retoume la mensualite a payer pour un pret en fonction du 
capital emprunte, du taux d'interet et de la duree du pret. 

Ce type de fonction financiere se retrouve couramment, dans Excel par exemple. En 
revanche, elle n'existe pas nativement dans PHP ni dans aucun module additionnel. Sa 
definition necessite quelques commentaires pour en comprendre l'ecriture. 

La formule de calcul d'une mensualite M est la suivante : 

M=(CxT)/[l-(l + T)- n ] 
C est le capital emprunte, designe par le parametre $capi tal . 

T est le taux mensuel sous forme de nombre decimal — tel que ne nous l'indique jamais 
notre banquier, qui prefere nous donner un taux annuel. Ce parametre annuel est passe a 
la fonction et designe par la variable $tauxann. n est la duree en nombre de mois. Le para- 
metre correspondant fourni a la fonction est exprime en annees au moyen du parametre 
$dureeann puis est converti en mois. Le quatrieme parametre de la fonction, $assur, 
permet de calculer le montant de l'assurance. II vaut 1 si le client desire s'assurer et 
dans le cas contraire. 
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La fonction commence par adapter les donnees bancaires usuelles a la formule du calcul 
financier. Le taux annuel, par exemple, est converti en taux mensuel decimal. Par exemple, 
5 % l'an devient 5/100/12, soit 0.00416666. La fonction calcule ensuite la mensualite au 
moyen de la formule ci-dessus puis retourne cette valeur arrondie au centime pres a l'aide 
de la fonction round ( ). 

Le script de l'exemple 7-4 s'acheve par l'utilisation de cette fonction avec des parametres 
scalaires puis avec des variables. 

Exemple 7-4. Fonction de calcul de pret 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>CALCUL DE PRETS</title> 
</head> 
<body> 
<?php 

function mensual ite($capital , Stauxann, $dureeann,$assur) 
{ 

//calcul du taux mensuel decimal 

$tauxmensuel=$tauxann/100/12; 

//calcul de la duree en mois 

$duree=$dureeann*12; 

//calcul de 1 'assurance soit 0.035% du capital par mois 

$ass=$assur*$capital*0.00035;//vaut si $assur vaut 

//calcul de la mensualite 

$mens=($capital*$tauxmensuel )/(l-pow( (l+$tauxmensuel ) ,-$duree)) + 

*$ass; 

return round($mens,2) ; 
} 

$mens = mensual itedOOOO, 5,3,1) ; 

echo "<h3>Pour un pret de 10000 n a S% l'an sur 3 ans, la mensualite est de ", 
*»$mens ," n assurance comprise</h3>" ; 
// 

$cap=80000;$taux=3.5;$duree=10; 
$mens = mensual ite($cap,$taux.$duree,0) ; 

echo "<h3>Pour un pret de $cap n a $taux% l'an sur $duree ans, la mensualite est 
**de ",$mens ," n sans assurance </h3>"; 
?> 

</body> 
</html> 

Le script retourne le resultat suivant : 



Pour un pret de 10000 n a 5% l'an sur 3 ans, la mensualite est de 303.21 n assurance 

comprise 

Pour un pret de 80000 n a 3.5% l'an sur 10 ans, la mensualite est de 791.09 n sans 

assurance 
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Au chapitre 6, vous avez dej a realise un formulaire de saisie de donnees pour un calcul de 
pret. La fonction que vous venez de creer peut etre incorporee a ce script pour rendre 
l'ensemble plus elegant. 

Retourner plusieurs valeurs 

PHP n'offre pas la possibilite de retourner explicitement plusieurs variables a l'aide d'une 
syntaxe du type : 

return $a,$b,$c, . . . 

Pour pallier cet inconvenient, il suffit de retourner une variable de type array contenant 
autant de valeurs que desire. Vous pourriez aussi envisager de retourner un objet dote de 
plusieurs proprietes, mais il serait quelque peu fastidieux de creer une classe et des objets 
specialement pour la circonstance si la creation d' objets ne faisait pas partie de la 
conception generale du script. 

L'exemple 7-5 illustre le retour de plusieurs valeurs par le biais de la creation d'une 
fonction appliquee a un nombre complexe qui retourne a la fois le module et 1' argument 
du nombre. 



Rappel 

Un nombre complexe s'ecrit a + \b, avec i 2 = - 1 . Son module est egal a la racine carree de (a 2 + b 2 ). Son 
argument est Tangle (Ox,OM) en radian si le point M a pour coordonnees (a,b). 

La fonction modarg( ) regoit comme parametres les nombres a et b passes dans les variables $reel et 
$imag et retourne un tableau associatif dont les cles sont les chaines "modul e" et "argument" avec les 
valeurs associees correspondantes. 



Exemple 7-5. Fonction de calcul sur des nombres complexes 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Nombres complexes</title> 
</head> 
<body> 
<div> 
<?php 

function modarg($reel ,$imag) 
{ 

//$mod= hypot($reel ,$imag) ; 

//ou encore si vous n'avez pas la fonction hypotOdu module standard 

$mod =sqrt($reel*$reel + $imag*$imag) ; 

$arg = atan2($imag,$reel ) ; 

return array("module"=>$mod, "argument"=>$arg) ; 
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//Appels de la fonction 

$a= 5; 

$b= 8; 

$complex= modarg($a,$b) ; 

echo "<b>Nombre complexe $a + $b i:</b><br /> module = ", $complex["module"] , 

^»"<br />argument = " ,$complex["argument"] , " radians<br />"; 

?> 

</div> 

</body> 

</html> 

Le script retourne le resultat suivant : 

Nombre complexe 5+8 i: 
module = 9.4339811320566 
argument = 1.0121970114513 radians 

Grace a 1' artifice consistant a retourner un tableau de valeurs, vous pouvez creer des 
fonctions qui retournent autant de valeurs que desire. Vous utiliserez cette derniere 
methode systematiquement pour retourner plusieurs valeurs. 

Les parametres par defaut 

II n'est pas rare dans l'ecriture de code XHTML de ne pas definir certaines valeurs 
d'attributs d'un element donne car vous savez qu'il prendra automatiquement une valeur 
par defaut. 

Par exemple, le formulaire ecrit de la facon suivante : 

<form action="machin.php"> 
est 1' equivalent de celui-ci : 

<form action="machin.php" method="get" enctype="application/x-www-form-url -encoded"> 

Les attributs method et enctype ayant les valeurs par defaut ci-dessus il n'est pas neces- 
saire de les preciser si ces valeurs vous conviennent. 

Lorsque vous creez une fonction personnalisee, vous pouvez proceder de meme et 
donner des valeurs par defaut aux parametres de la fonction. II suffit pour cela d'affecter 
une valeur au parametre dans la definition de la fonction (repere O de l'exemple 7-6). 

Si vous ne donnez pas de valeur a ces parametres lors de l'appel de la fonction, ils auront 
automatiquement la valeur definie dans la declaration de la fonction (repere @). 

L'exemple 7-6 illustre la definition d'une fonction elementaire qui retourne un prix hors 
taxes en utilisant comme parametres le prix TTC et le taux de TVA. 

En realisant les appels : 

echo ht(154,19.6) 
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ou : 

echo ht(154) 

vous obtenez le meme resultat, a savoir 123.82, le parametre $tax designant le taux de 
TVA valant 19.6 par defaut. 

En revanche, l'appel suivant : 

echo ht(154, 5.5) 

retourne la valeur 145.53 car le parametre $tax est defini explicitement a la valeur 5.5. 

Exemple 7-6. Fonction avec une valeur par defaut 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Fonction avec une valeur de parametre par defaut</title> 
</head> 
<body> 
<div> 

<?php 

function ht($prix,$tax=19.6) <— O 

{ 

return "Prix Hors Taxes :". round($prix*(l-$tax/100) ,2) ; 
} 

$prix=154; 

echo "Prix TTC= $prix € " ,ht($prix) , " €<br />";<—© 
echo "Prix TTC= $prix € " ,ht($prix,19.6) , " €<br />"; 
echo "Prix TTC= $prix € " ,ht($prix,5.5) , " €<br />"; 
?> 

</div> 
</body> 
</html> 



Attention 

Dans la definition d'une fonction, tous les parametres qui ont une valeur par defaut doivent figurer en 
dernier dans la liste des variables. 

La fonction ht( ) de I'exemple 7-6 peut etre appelee en omettant le deuxieme parametre avec ht(154). 
En revanche, si vous la definissez par le biais de : 

function ht($tax=19.6,$prix) { } 

et que vous tentiez de I'appeler a I'aide du code ht( ,154) ou ht(154), elle ne fonctionne pas, le 
premier code provoquant une erreur fatale et un arret du script et le second un avertissement indiquant 
qu'il manque un argument. 
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Les fonctions avec un nombre de parametres variable 

Dans les definitions precedentes de fonctions, vous aviez 1' obligation de definir claire- 
ment le nombre de parametres utilises par la fonction. Cela pose un probleme si le nombre 
de parametres n'est pas connu a l'avance. II existe heureusement plusieurs methodes, 
adaptees a differentes circonstances, pour creer des fonctions acceptant un nombre variable 
de parametres. 



Les parametres de type array 

En passant un tableau comme parametre a une fonction, cette derniere n'a en apparence 
qu'un seul parametre. Ce sont en fait les elements du tableau qui sont utilises et traites 
par la fonction, chacun devenant comme un parametre particulier. C'est done dans le 
corps de la fonction que vous pourrez determiner le nombre d' elements du tableau et 
utiliser cet ensemble de valeurs, qui seront lues a l'aide d'une boucle. 

La fonction creee a l'exemple 7-7 realise le produit de N nombres qui lui sont passes en 
tant qu'elements du tableau $tab, affiche le nombre de parametres et retourne leur 
produit. Elle peut, par exemple, servir au calcul de la factorielle d'un entier sans pour 
autant etre recursive, pour peu que le tableau contienne une suite de nombres creee au 
moyen de la fonction range ( ). 

*~ Exemple 7-7. Produit des elements d'un tableau 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Nombre de parametres variable</title> 
</head> 
<body> 
<div> 
<?php 
function prod($tab) 



$n=count($tab) ; 

echo "II y a $n parametres :"; 

$prod = 1; 

foreach($tab as $val ) 

{ 

echo "$val , " ; 

$prod *=$val ; 
} 

echo " le produit vaut "; 
return $prod; 
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$tabl= ranged, 10); 

echo "Produit des nombres de 1 a 10 :", prod($tabl) , "<br />"; 

$tab2 = array(7,12,15,3,21); 

echo "Produit des elements :", prod($tab2) , "<br />"; 

?> 

</div> 

</body> 

</html> 

Le script retourne le resultat suivant : 

Produit des nombres de 1 a 10 :I1 y a 10 parametres :1, 2, 3, 4, 5, 6, 7, 8, 9, 10, le 

produit vaut 3628800 

Produit des elements :I1 y a 5 parametres :7, 12, 15, 3, 21, le produit vaut 79380 



Les fonctions particulieres de PHP 

Vous pouvez obtenir des informations sur les parametres d'une fonction a l'aide de fonc- 
tions specialisees de PHP. 

La fonction suivante : 

integer func_num_args( ) 

s'utilise sans argument et seulement dans le corps meme d'une fonction. Elle retourne le 
nombre d'arguments passes a cette fonction. 

Pour acceder a chacun des parametres, vous utilisez ensuite la fonction : 

divers func_get_arg(integer $N) 

qui retourne la valeur du parametre passe a la position $N. Comme dans les tableaux, le 
premier parametre a l'indice 0. Vous pouvez done lire chacun des parametres a l'aide 
d'une boucle. 

La fonction suivante : 

array func_get_args( ) 

s'utilise sans parametre et retourne un tableau indice contenant tous les parametres 
passes a la fonction personnalisee. 

Pour illustrer l'utilisation de ces deux fonctions, vous allez reecrire la fonction prod( )de 
l'exemple 7-7 pour detecter le nombre et la valeur des parametres sous deux formes 
differentes et en faire le produit. 

La fonction prodK ) determine le nombre de parametres a l'aide de f unc_num_args( ) puis 
les lit un par un a l'aide d'une boucle for. La fonction prod2( ) recupere le tableau conte- 
nant l'ensemble des parametres a l'aide de func_get_args() puis les recupere a l'aide 
d'une boucle foreach. 
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Remarque 

La definition des fonctions prodK ) et prod2( ) ne contient plus I'enumeration des parametres mais ce 
n'est pas obligatoire. Vous pouvez tres bien preciser un nombre minimal de parametres et en passer 
davantage — mais jamais moins — lors de I'appel. 



Exemple 7-8. Produit d'un nombre indetermine de nombres 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Produit d'un nombre indetermine d'arguments</title> 
</head> 
<body> 
<div> 
<?php 

//Utilisation de func_num_arg( ) et func_get_arg( ) 
function prodK) 
{ 

$prod - 1; 

//determine le nombre d'arguments 

$n=func_num_args( ) ; 

for($i=0;$i<$n;$i++) 

{ 
echo func_get_arg($i ) ; 
($i==$n-l)?print(" = "):print(" * "); 
$prod *=func_get_arg($i ) ; 

} 

return $prod; 
} 

//Appels de la fonction prodK) 

echo "Produit des nombres :", prodl(5,6,7,8,ll,15) , "<br />"; 
$a=55;$b=22;$c=5;$d=9; 

echo "Produit de " ,prodl($a,$b,$c,$d) ,"<hr />"; 
//it*********************************** 

//Utilisation de func_get_args( ) seule 
//it*********************************** 

function prod2() 



( 



$prod = 1; 

//Recuperation des parametres dans un tableau 
Stabparam = func_get_args( ) ; 
foreach($tabparam as $cle=>$val) 
{ 
//Presentation 
echo $val ; 
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($cle==count($tabparam)-l)?print(" = "):print(" * "); 

//Calcul du produit 

$prod *=$val ; 
} 

return Sprod; 
} 

echo "Produit des nombres :", prod2(5,6,7,8,ll,15) , "<br />" 
$a=55;$b=22;$c=5;$d=9; 

echo "Produit de " ,prod2($a,$b,$c,$d) , "<hr />"; 
?> 

</div> 
</body> 
</html> 

Vous obtenez l'affichage suivant pour les deux fonctions : 

Produit des nombres :5 * 6 * 7 * 8 * 11 * 15 = 277200 
Produit de 55 * 22 * 5 * 9 = 54450 



Portee des variables 

Toutes les variables ont une portee determinee selon le contexte. 



Variables locales et globales 

Toutes les variables utilisees dans la declaration d'une fonction sont, sauf indication 
contraire, locales au bloc de definition de la fonction. Cela permet d'utiliser n'importe 
quel nom de variable dans le corps de la fonction et comme valeur de retour, meme si ce 
nom est deja utilise dans le reste du script (il vaut toutefois mieux eviter ces repetitions 
de noms de variables). Toutes les variables qui sont definies en dehors d'une fonction ou 
d'une classe sont globales et accessibles partout dans le script qui les a creees. 

En consequence, toute modification du parametre d'une fonction operee dans le corps de 
celle-ci n'a aucun effet sur une variable externe a la fonction et portant le meme nom. 

Dans l'exemple 7-9, la fonction waytu( ) utilise le parametre $interne, qui est local a la 
fonction, et les deux variables globales $interne et $externe, initialisees en dehors de la 
fonction. Quelle que soit la variable utilisee lors des appels de la fonction, les deux varia- 
bles globales $externe et $interne ne sont pas modifiees, comme le montrent les resultats 
affiches. 

Le corps de la fonction comprend egalement la variable locale $externe — une exception 
a la regie enoncee precedemment. L' affectation d'une valeur a cette variable ne se reper- 
cute pas en dehors du corps de la fonction, la variable globale $externe (repere O) 
gardant sa valeur initiale. 
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Exemple 7-9. Variables locales et globales 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Variables locales et variables globales</title> 
</head> 
<body> 
<div> 
<?php 

$externe="dehors" ; <— O 
$interne ="dedans"; 
function waytu($interne) 
{ 
$interne = "Si tu me cherches, je suis ".$interne ." <br />"; 
Sexterne = "n'importe quoi!"; 
return Sinterne; 
} 

waytu($interne) ;//affiche "Si tu me cherches, 

Sinterne," <br />" ;//affiche "dedans" 

waytu($externe) ;//affiche "Si tu me cherches, 

Sexterne," <br />" ;//affiche "dehors" 



je suis dedans" 
je suis dehors" 



echo 

echo 

echo 

echo 

?> 

</div> 

<p> 

<a href="http://val idator.w3.org/check?uri=referer"Ximg 

src=" http://www.w3.org/Icons/val id-xhtml 11" 

alt="Valid XHTML 1.1" height="31" width="88" /></a> 
</p> 
</body> 
</html> 

Si vous souhaitez utiliser la valeur d'une variable globale dans le corps d'une fonction, il 
vous faut declarer cette variable dans le corps de la fonction en la faisant preceder du 
mot-cle gl obal pour les versions de PHP anterieures a la 4.1 et, de maniere plus elegante 
depuis, en utilisant le tableau associatif superglobal $GL0BALS. Les cles de ce dernier sont 
les noms des variables globales du script sans le signe "$". 

Pour utiliser la valeur de la variable globale $mavar, vous ecrivez par exemple : 

$GLOBALS["mavar"] 

L'exemple 7-10 illustre l'emploi de variables globales dans une fonction pour rediger un 
message. La fonction messageO utilise le parametre $machin, qui contient le nom d'une 
ville, et les valeurs des variables globales $truc et $intro declarees de deux manieres 
differentes. 
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Exemple 7-10. Utilisation de variables globales dans une fonction 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Fonctions utilisant des variables globales</title> 
</head> 
<body> 
<div> 
<?php 

function message($machin) 
{ 

global $truc; 

Smachin = $GL0BALS[ 'intro' ] . " je suis $truc $machin <br />"; 

$truc = "zzzzzzzzzzzzzzzzzzzzz! " ; 

return Smachin; 
} 

$intro= "Ne me cherches pas,"; 
$truc = " parti "; 
echo messaget" a Londres"); 
$intro= "Si tu me cherches,"; 
$truc=" revenu "; 
echo messaget" de Nantes"); 
echo $truc; 
?> 

</div> 
</body> 
</html> 

Le script retourne le resultat suivant : 

Ne me cherches pas, je suis partie a Londres 
Si tu me cherches, je suis revenue de Nantes 
zzzzzzzzzzzzzzzzzzzzz! 

Chaque modification de la valeur des variables $truc et $intro est sensible dans la fonc- 
tion messaget ). En particulier, la modification de la variable globale $truc dans le corps 
de la fonction est repercutee dans le reste du script, ce qui peut creer un danger si vous 
n'y prenez garde. 

Par precaution, il est recommande de n'utiliser les variables globales dans une fonction 
que comme source de donnee et de ne pas modifier leur valeur. Si, comme il convient, 
vous prenez la bonne habitude de constituer des bibliotheques de fonctions externes, le 
code de celles-ci n'est plus visible directement. L'utilisation de variables globales risque 
d'operer des modifications sans qu'elles soient visibles. La recherche d'erreurs peut alors 
devenir difficile. 
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Les variables statiques 

Lors de l'appel d'une fonction, les variables locales utilisees dans le corps de la fonction 
ne conservent pas la valeur qui leur est affectee par la fonction. La variable redevient en 
quelque sorte vierge apres chaque appel. 

Pour conserver la valeur precedemment affectee entre deux appels d'une meme fonction, 
il faut declarer la variable comme statique en la faisant preceder du mot-cle stati c, et ce 
avant de l'utiliser dans le corps de la fonction. Le deuxieme appel de la fonction peut 
reutiliser la valeur qu'avait la variable apres le premier appel de la fonction, et ainsi de 
suite a chaque nouvel appel. 

L'utilisation typique des variables statiques concerne les fonctions qui effectuent des 
operations de cumul. Une variable declaree comme static ne conserve toutefois une 
valeur que pendant la duree du script. Lors d'une nouvelle execution de la page, elle 
reprend sa valeur initiale. II ne faut done pas compter sur cette methode pour transmettre 
des valeurs d'une page a une autre, meme si ces dernieres appellent la meme fonction 
contenant des variables statiques. 

Dans l'exemple suivant : 

function acquis($capital ,$taux) 
{ 

static Sacquis; 
//corps de la fonction 

} 

la variable $acqui s n'a pas de valeur initiale et doit etre affectee dans la suite du code. Par 
contre, vous pouvez lui donner une valeur initiale lors de sa declaration en ecrivant : 

function acquis($capital ,$taux) 
{ 

static $acquis=l; 
//corps de la fonction 

} 

L'exemple 7-11 cree une fonction acquis ( ) qui affiche successivement les valeurs acqui- 
ses d'un placement realise a un taux fixe. L'utilisateur choisit le capital et le taux dans 
deux champs texte d'un formulaire de saisie, nommes capital et taux. 

Vous utilisez dans le corps de la fonction deux variables statiques, $acquis et $an, qui 
representent le coefficient multiplicateur du pret et la duree du placement. Entre chaque 
appel de la fonction, ces variables conservent leur valeur pour permettre d'afficher la 
valeur acquise annee apres annee a l'aide d'une boucle. 

La fonction retourne la valeur acquise totale a chaque appel et cree une boite d'alerte en 
JavaScript contenant la meme valeur du capital acquis. 

La partie XHTML du fichier consiste uniquement en la creation du formulaire de saisie 
des informations necessaires au calcul du placement. 
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Exemple 7-11. Utilisation d'une variable statique 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Variables statiques</title> 
</head> 
<body> 

<form method="post" action="fonctionll.php" > 
<fieldset> 

<legend>Placements</legend> 
<p>Indiquez votre CAPITAL : 

<input type="text" name="capital " value=""/X/p> 
<p>Indiquez votre TAUX en %: 
<input type="text" name="taux" value=""/X/p> 
<input type="submit" name="calcul " value="CALCULER"/Xbr /> 
</fieldset> 
</form> 
</body> 
</html> 

<?php 

//Definition de la fonction 

function acquis($capital ,$taux) 

{ 

static $acquis=l; 

static $an=l; 

$coeff = l+$taux/100; 

Sacquis *= $coeff; 

echo "<script type=\"text/javascript\" > alertCEn San ans vous 

*»aurez ". round($capital*$acquis,2) ." euros') </script>"; 

$an++; 

return round($capital*$acquis,2) ; 
} 

//Utilisation de la fonction 

if(isset($_POST["taux"])&& isset($_POST[" capital"] )&& 
*is_numeric($_POST[ "capital"]) && is_numeric($_POST["taux"] ) ) 
{ 
for($i=l;$i<5;$i++) 



echo "Au bout de $i ans vous aurez 
*$_POST["taux"]). " euros <br />"; 



acquis ($_POST[" capital "], 



) 
?> 



La figure 7-4 donne un apercu du formulaire de saisie ainsi que de l'affichage des resul- 
tats dans la page et sous forme de boite d'alerte JavaScript. 
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Figure 7-4 

Utilisation des variables statiques dans un formulaire de saisie 



Passer des arguments par reference 

Dans les definitions des fonctions que vous venez de creer, les arguments sont passes par 
valeur. C'est done une copie de ces variables qui est utilisee par la fonction. En aucun cas 
les modifications de la valeur des parametres ne sont visibles a l'exterieur de la fonction. 

Comme vous l'avez vu au chapitre 2 pour l'affectation des variables par reference, il est 
possible de passer a une fonction un argument par reference. Dans ce cas, les modifica- 
tions effectuees dans le corps de la fonction sont repercutees a l'exterieur. 

Vous avez le choix entre deux possibilites, passer des arguments par reference de facon 
systematique (voir l'exemple 7-12) et passer des arguments par reference occasionnelle- 
ment (voir l'exemple 7-13). 

Si vous voulez que le passage des arguments par reference soit fait systematiquement, il 
vous faut faire preceder les parametres que vous desirez passer par reference du signe & 
dans la definition de la fonction elle-meme. 

Vous utilisez pour cela la syntaxe suivante : 

function nom_fonction(&$paraml,&$param2 ) 

{ 

//corps de la fonction 

} 

II n'y a pas obligation de passer tous les parametres par reference dans la meme fonction, 
et vous pouvez n'en passer qu'une partie. Dans l'exemple 7-12, la fonction prod( ) recoit 
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comme parametre un tableau passe par reference et un coefficient passe par valeur. La 
fonction verifie d'abord que chaque element du tableau est numerique. Si tel est le cas, il 
est multiplie par le coefficient passe en second parametre. 

La fonction retourne ensuite un tableau contenant ces nouvelles valeurs, ou, si un seul 
des elements n'est pas numerique, retourne FALSE. 

L'ensemble des resultats du script montre que le tableau passe en parametre a ete modifie 
et qu'il est le meme que celui retourne par la fonction (la variable $result). En pratique, 
il serait inutile de retourner une valeur dans le corps de la fonction. Remarquez bien en 
revanche que toutes les valeurs initiales sont perdues. 

Exemple 7-12. Passage d'arguments par reference 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Passage par reference</title> 
</head> 
<body> 
<div> 

<?php 

//Definition de la fonction 
function prod(&$tab,$coeff ) 
{ 
foreach($tab as $cle=>$val) 
{ 
if (is_numeric($val )) 
{$tab[$cle]*=$coeff;} 
else 
{ 
echo "Erreur : Le tableau est non numerique <br />"; 
return FALSE; 



return Stab; 
} 

echo "Tableau numerique <br />"; 
Stabnum = ranged, 7) ; 

echo "Tableau avant l'appel <br />",print_r( Stabnum) ,"<br />"; 
//Passage du tableau a la fonction 
$result= prod($tabnum,3.5) ; 

echo "Tableau resultat <br />",print_r( Sresul t) , "<br />"; 
echo "Tableau initial apres l'appel <br />",print_r( Stabnum) , "<br />" 
echo "Tableau alphabetique <br />"; 
$tabalpha= rangeC'A" , "F") ; 
$resultal=prod($tabalpha, 3); //retourne FALSE 
echo "Tableau apres l'appel <br />",print_r( Stabalpha) , "<br />"; 
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?> 

</div> 
</body> 
</html> 



Le script retourne le resultat suivant : 



Tableau numerique 

Tableau avant 1 'appel 

Array ( [0] => 1 [1] => 2 [2] => 3 [3] => 4 [4] => 5 [5] => 6 [6] => 7 ) 1 

Tableau resultat 

Array ( [0] => 3.5 [1] => 7 [2] => 10.5 [3] => 14 [4] => 17.5 [5] => 21 [6] => 24.5 ) 1 

Tableau initial apres 1 'appel 

Array ( [0] => 3.5 [1] => 7 [2] => 10.5 [3] => 14 [4] => 17.5 [5] => 21 [6] => 24.5 ) 1 

Tableau alphabetique 

Erreur : Le tableau est non numerique 

Tableau apres 1 'appel 

Array ( [0] => A [1] => B [2] => C [3] => D [4] => E [5] => F ) 1 

La deuxieme possibilite s'offre a vous si vous voulez que le passage des arguments par 
reference ne soit pas systematique mais occasionnel et choisi a chaque appel de la fonction. 

Dans ce cas, vous definissez la fonction comme pour un passage des arguments par 
valeur. C'est seulement lors de l'appel que vous choisissez le passage par reference en 
faisant preceder chaque parametre du signe &. 

II est alors evident que vous ne pouvez plus passer de valeurs scalaires mais seulement 
des variables. L'exemple 7-13 en donne une illustration. 

Exemple 7-13. Passage par reference occasionnel 

<?php 

//Definition de la fonction 

function &hausse($prix,$pourcent) 

{ 

$prix *=(l+$pourcent/100); 

return round($prix,2) ; 
} 

//Utilisation de la fonction 
$prix = 1500; 

echo hausse($prix,12) ,"<br />";//par valeur 
echo $prix,"<br />"; 

echo hausse(&$prix,12) , "<br />";//par reference 
echo $prix,"<br />"; 
?> 

L' instruction suivante : 

echo hausse($prix,12) 
affiche la valeur 1680, et : 

echo $prix 
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affiche 1500, montrant que la valeur de la variable $prix, passee par valeur, n'a pas ete 
modifiee. 

L'appel de la fonction par le code suivant : 

echo hausse(&$prix,12) 

affiche le meme resultat, mais il est necessaire de verifier ensuite que la variable $prix 
vaut egalement 1680, le deuxieme appel etant fait par reference. Cette deuxieme solution 
est preferable lorsque vous souhaitez creer des bibliotheques de fonctions dont le code ne 
soit pas directement visible dans le script. Ainsi, le passage par reference ne risque pas 
d'etre involontaire. 

Cette possibilite est toutefois consideree aujourd'hui comme obsolete, et le passage par 
reference doit faire partie de la declaration de la fonction. En consequence, il est important 
de bien documenter vos fonctions pour ne pas oublier quels sont les arguments passes par 
reference et ceux qui ne le sont pas. 

Cas particuliers 

Dans cette section, nous allons examiner divers cas particuliers qui peuvent se reveler 
utiles. A savoir les fonctions dynamiques, les fonctions conditionnelles, les fonctions 
definies a l'interieur d'une autre fonction et les fonctions recursives. 

Les fonctions dynamiques 

Les fonctions que vous avez ecrites jusqu'a present ont un nom fixe et bien defini dans 
les scripts. La lecture du script permet de connaitre immediatement la fonction appelee. 
PHP offre la possibilite de travailler avec des noms de fonctions dynamiques, qui peuvent 
etre variables et done dependants de l'utilisateur du site ou de 1' interrogation d'une base 
de donnees. 

Pour realiser cette operation, il faut que le nom de la fonction — sans les parentheses ni 
les parametres — soit contenu dans une variable de type chaine de caracteres. Pour utiliser 
la fonction il n'y a plus ensuite qu'a faire suivre cette variable de parentheses et de ses 
parametres eventuels. 

Le code suivant : 



$ch ="phpinfo" ; 
$ch(); 



equivaut au code : 

phpinfoO 
qui appelle directement la fonction phpi nfo( ). 
De meme, le code suivant : 

|$ch = "date"; 
echo $ch(" D d/M/Y H:i:s "); 
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permet d' appeler la fonction date ( ) avec comme parametre la chaine "D d/M/Y H:i:s". 

II est envisageable de creer un tableau de chaines contenant des noms de fonctions et 
d'appeler celles-ci en ecrivant le nom de l'element du tableau suivi de parentheses et de 
parametres s'il en existe. 

Le code suivant : 

<?php 

$tabfonc= array ( "phpinfo" ."date") ; 

$tabfonc[0](); 

echo $tabfonc[l]("D d m Y H : i : s " ) ; 

?> 

serait ainsi 1' equivalent des precedents. 

Pour illustrer les possibilites des fonctions dynamiques, l'exemple 7-14 cree un formu- 
laire de saisie permettant a l'utilisateur d'entrer un nom de fonction native de PHP et la 
valeur d'un parametre. L'envoi du formulaire provoque l'affichage de la valeur desiree. 

Le formulaire contient deux zones de saisie de texte. La premiere, nommee "fonction", 
permet la saisie du nom de la fonction, et la seconde, nommee "param", de la valeur du 
parametre. 

Le code contenu dans l'attribut value des elements O'nput /> (reperes Q) permet de 
conserver l'etat du formulaire avant son envoi et done de reafficher les donnees saisies 
par l'utilisateur. 

Le code PHP de gestion du formulaire verifie d'abord l'existence d'une saisie de nom de 
fonction et d'un parametre (repere ©) puis, s'ils existent, verifie que la fonction choisie 
existe en PHP (ou dans le script lui-meme repere ©) puis, selon les cas, affiche la valeur 
desiree (repere 0) ou un message d'erreur (repere 0). 

Exemple 7-14. Fonctions dynamiques 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title> Fonctions dynamiques</title> 
</head> 
<body> 

<form method="post" action="fonctionl4.php" > 
<fieldset> 

<l egend>Choisissez votre fonction et son parametre</legend> 
<input type="text" name="fonction" value="<?= 
^isset($_POST["fonction"]) ? $_POST["fonction"] : "" ?>"/><-0 
<input type="text" name="param" value="<?= isset($_POST["param"] ) ? 
*$_POST["param"] : "" ?>"/>^0 
<input type="submit" val ue="Calculer"/> 
</fieldset> 
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</form> 

<!-- Code PHP : gestion du formulai re--> 

<?php 

if((isset($_POST["fonction"])&& $_POST["fonction"] !="" ) && $_POST["param"] !=" 

{ 

$fonction - $_POST["fonction"] ; 

$param = $_POST["param"] ; 

if (function_exists($fonction) ) <— © 

{ 
echo "Resultat : $fonction($param) = " ,$fonction($param) ; <— © 

} 

else echo "ERREUR DE FONCTION! "; <-© 
} 

?> 

</body> 
</html> 

La figure 7-5 montre le resultat obtenu en choisissant la fonction log. 
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Resultat : log(2000) = 7.6009024595421 



Figure 7-5 

Utilisation de fonctions dynamiques 



Les fonctions conditionnelles 

Une fonction est dite conditionnelle si elle est definie a l'interieur d'un bloc 1 f . Sa creation 
se realise alors de la meme facon que pour une fonction ordinaire, mais elle n'est utilisable 
que si l'instruction if qui la contient a ete executee et, bien sur, si l'expression condi- 
tionnelle contenue dans if a la valeur booleenne TRUE. Ces conditions etant remplies, la 
fonction peut etre appelee normalement dans tout le code qui suit la condition i f . 

L'exemple 7-15 illustre cette possibilite. L'appel de la fonction ordinaire teste ) 
(repere O 1 montre que Ton peut l'appeler alors meme qu'elle n'est definie qu'en fin de 
script (repere ©), ce que nous avons deja vu. Par contre, l'appel de la fonction sal ut( ) en 
debut de script (repere ©) provoquerait une erreurfatale (message: Fatal error: Call to 
undefined function sal ut( )) et done l'arret immediat du script. Cette fonction est en effet 
conditionnelle et n'est accessible que lorsque le script atteint la ligne du if (repere ©) 
qui verifie si l'heure obtenue par la fonction dateO (repere © : voir le chapitre 8 pour 
plus de details sur son fonctionnement) est inferieure a 18. Dans ce cas la fonction 
salutO est definie (repere©). Notre exemple pourrait s'arreter la mais, dans le but 
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d'eviter l'erreur fatale signalee ci-dessus, nous utilisons un bloc el se (repere ©) qui cree 
une autre version de la fonction sal ut( ) quand la condition if n'est pas verifiee. L'appel 
de cette fonction est alors possible en fin de script (repere @) 

Exemple 7-15. Fonctions conditionnelles 

<?php 

test( ) j <-© 

//salutO; Cet appel provoquerait une erreur fatale<— © 
$heure=date("H"); <— © 
//Definition d'une fonction conditionel le 
if($heure<18) <-© 



( 



function salut()<— © 
echo "Bonjour : Fonction accessible seulement avant 18h00 <br />"; 



) 



else <— © 



function salutO 
{ 

echo "Bonsoir : Fonction accessible seulement apres 18h00 <br />"; 
} 

} 

//Definition d'une fonction ordinaire 

function testO <— © 

{ 

echo "Fonction accessible partout <br />"; 

return TRUE; 
} 

salutO; <— © 
?> 



Fonction definie dans une autre fonction 

Dans le cas d'une fonction definie a l'interieur d'une autre fonction, le code de creation 
de la fonction n'est plus dans un bloc if mais dans le bloc qui constitue le corps d'une 
autre fonction. La fonction incluse n'est alors utilisable que si celle qui la contient a ete 
appelee une fois, sinon PHP leve une erreur fatale. L' inconvenient de cette methode est 
que la fonction « conteneur » ne doit etre appelee qu'une seule et unique fois, sinon nous 
obtenons a nouveau une erreur fatale pour cause de redefinition de la fonction incluse ce 
qui, avouons-le, rend cette fonctionnalite un peu dangereuse. L'exemple 7-16 illustre 
cette possibilite de creation de fonction. Le script contient la definition de la fonction 
pa rent ( ) qui contient elle-meme la definition de la fonction enfant ( ) (repere ©). L'appel 
de cette derniere en debut de script provoquerait une erreur fatale (repere ©) mais, lors- 
que que la fonction pa rent ( ) a ete appelee une fois (repere ©), la fonction enfant ( ) peut 
etre appelee autant de fois que Ton veut (reperes © et ©). 



Les fonctions 

Chapitre 7 



Exemple 7-16. Fonction incluse dans une autre 

<?php 

//enfant();//ERREUR FATALE ^Q 

function parent()<— © 

{ 

echo "Bonjour les enfants! <br />"; 

function enfant()<— © 
{ 

echo "Bonsoir papa !<br />"; 



parent( ) ; <— 
enfant( ) ; <— 
enfant( ) ; <— 
?> 



Le script affiche les resultats suivants 



Bonjour les enfants! 
Bonsoir papa ! 
Bonsoir papa ! 



Les fonction recursives 

Une fonction est dite recursive si, a l'interieur de son corps, elle s'appelle elle-meme 
avec une valeur de parametre different (sinon elle boucle). Chaque appel constitue un 
niveau de recursivite. L' exemple le plus classique est celui de la fonction qui retourne la 
factorielle d'un nombre entier n (notee n! que nous avons deja calculee d'une maniere 
differente a 1' exemple 7-7). Pour calculer n!, une fonction recursive calcule n x (n - 1)!, 
ce qui implique un nouvel appel de la fonction factorielle et ainsi de suite jusqu'a calculer 
1 ! (par definition 0!=1) puis on remonte jusqu'a n!. 

Ce qui donne, par exemple, le code suivant : 

<?php 

function facto($n) 

{ 

if ($n==l) return 1; 

else {return $n*facto($n-l) ; } 



echo "factoriel 
?> 



",facto(150); 



Un grand autre classique de la recursivite est la programmation du jeu dit des tours de 
Hanoi. Imagine par le mathematicien francais Edouard Lucas, il consiste a deplacer des 
disques de diametres croissants d'un piquet de « depart » a une piquet d'« arrivee » en 
passant par un piquet « intermediate » et ceci en un minimum de coups, sachant qu'on 
ne peut deplacer qu'un disque a la fois et que celui -ci ne peut etre place que sur un disque 
plus grand que lui ou sur un piquet vide. Au depart les disques sont empiles sur un des 
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piquets en ordre decroissant. La figure 7-6 presente une configuration de depart avec six 
disques. 



A 



Figure 7-6 

Les tours de Hanoi 

Pour programmer le jeu, les piquets seront numerates de 1 a 3 de gauche a droite, et on 
remarquera que le piquet intermediate a le numero 6 - « depart » - « arrivee ». Quand le 
nombre de disques est faible (au minimum 3) il est assez aise de gagner mais, lorsqu'il 
augmente, ceci demande un peu de reflexion car il faut parvenir au resultat en un mini- 
mum de coups. Pour une quantite N de disques, ce nombre de coups minimum est 
toujours egal a 2 N - 1. Comme pour la factorielle, l'idee generale pour effectuer une 
action pour N disques est de la realiser d'abord pour N - 1 disques, puis pour N - 2 et 
ainsi de suite jusqu'a un seul disque ce qui constitue une action elementaire facile. On 
remonte alors pas a pas jusqu'a N. Pour deplacer, par exemple, trois disques du piquet 1 
vers le piquet 2 on effectue les operations suivantes : 

Deplacez un disque du piquet 1 vers le piquet 2 

Deplacez un disque du piquet 1 vers le piquet 3 

Deplacez un disque du piquet 2 vers le piquet 3 

Deplacez un disque du piquet 1 vers le piquet 2 

Deplacez un disque du piquet 3 vers le piquet 1 

Deplacez un disque du piquet 3 vers le piquet 2 

Deplacez un disque du piquet 1 vers le piquet 2 

L'exemple 7-17 donne le code de resolution du jeu. S'il reste un disque a deplacer nous 
avons Taction elementaire du depart vers l'arrivee (repere O * sinon il faut deplacer N - 1 
disques du depart vers l'intermediaire (repere©) puis N-l disques de l'intermediaire 
vers l'arrivee (repere ©). 

Exemple 7-17. Les tours de Hanoi' 

<?php 

function hanoi ($nb,$dep,$arr) 



{ 



if ($nb==l) echo "Deplacez un disque du piquet $dep vers le piquet 
*$arr <br />"; <-© 
else 
{ 
$inter=6-$dep-$arr; 
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hanoi ($nb-l,$dep, Sinter) ; <— © 

echo "Deplacez un disque du piquet $dep vers le piquet $arr <br />"; 

hanoi C$nb-1, Sinter, Sarr) ; <— © 
} 
} 

hanoi (4,1,2); 
?> 

L'affichage des operations realisees pour deplacer quatre disques du piquet 1 vers le 
piquet 2 est le suivant : 
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II comporte bien 15 displacements (soit 2 4 - 1) et on peut remarquer que les lignes paires 
du deplacement hanoi(4,l,2) correspondent au deplacement hanoi(3,l,2). 



Exercices 



Exercice 1 

Creez une fonction PHP qui affiche une boite d'alerte a partir de la fonction JavaScript 
dont la syntaxe est alert("chaine_de caracteres"). Cette fonction peut etre appelee avec 
comme parametre le texte du message a afficher. Elle est particulierement utile pour affi- 
cher des messages d'erreur de maniere elegante, sans que ces derniers restent ecrits dans 
la page. 

Exercice 2 

Ecrivez une fonction de lecture de tableaux multidimensionnels en vous inspirant de 
l'exemple 7-3. L'affichage se fait sous forme de tableau XHTML dont les titres sont les 
cles des tableaux. 

Exercice 3 

Ecrivez une fonction qui retourne la somme de la serie de terme general u n = x 2 " + 1 /nl. 
Les parametres de la fonction sont n pour le nombre d' iterations et d pour le nombre de 
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decimales affichees pour le resultat. II est possible de reutiliser la fonction prod( ) presen- 
tee dans ce chapitre pour calculer la factorielle n\. 

Exercice 4 

Ecrivez une fonction dont le parametre passe par reference est un tableau de chaines de 
caracteres et qui transforme chacun des elements du tableau de maniere que le premier 
caractere soit en majuscule et les autres en minuscules, quelle que soit la casse initiale 
des elements, meme si elle est mixte. 

Exercice 5 

A partir de la fonction sinus de PHP, ecrivez une fonction qui donne le sinus d'un angle 
donne en radian, en degre ou en grade. Les parametres sont la mesure de Tangle, et 
1' unite est symbolisee par une lettre. Le deuxieme parametre doit avoir une valeur par 
defaut correspondant aux radians. 

Exercice 6 

Creez une fonction de creation de formulaires comprenant une zone de texte, une case 
d'option (radio button), un bouton Submit et un bouton Reset. Choisissez comme para- 
metres les attributs des differents elements XHTML en cause. Chaque appel de la fonc- 
tion doit incorporer le code XHTML du formulaire a la page. 

Exercice 7 

Decomposez la fonction precedente en plusieurs fonctions, de facon a constituer un 
module complet de creation de formulaire. Au total, il doit y avoir une fonction pour l'en- 
tete du formulaire, une pour le champ texte, une pour la case d'option, une pour les 
boutons Submit et Reset et une pour la fermeture du formulaire. Incorporez ces fonctions 
dans un script, et utilisez-les pour creer un formulaire contenant un nombre quelconque 
de champ de saisie de texte et de cases d'option. 

Exercice 8 

Programmez les coefficients du binome (ou triangle de Pascal). Pour memoire, il s'agit 
de la suite suivante : 

1 

121 

1331 

14641 

etc. 

La premiere colonne et la diagonale valent toujours 1 et chaque autre element est egal a 
la somme de celui qui est au-dessus et de celui qui se trouve sur la diagonale gauche (par 
exemple 3=2+1 ou bien 6=3+3). 



8 



Dates et calendriers 



Les fonctions de date de PHP permettent d'afficher le jour, la date et l'heure sur les pages 
Web, qu'elles soient statiques ou creees dynamiquement. 

La gestion du temps se revele non moins utile pour determiner la duree de validite des 
cookies, stocker dans une base de donnees des informations de date de commande ou 
calculer un delai. 



Les dates 



La revolution du systeme decimal, il y a deux siecles, n'a pas atteint la gestion du temps. 
Vieux des premiers ages babyloniens, le systeme sexagesimal, consistant a diviser le 
jour en vingt-quatre heures de soixante minutes de soixante secondes, continue done 
d'empoisonner nos calculs de duree. 

Les informaticiens ne pouvaient se contenter d'un systeme dans lequel l'ajout d'une 
seconde peut amener a changer d'heure, de jour, d'annee et meme de siecle ou de mille- 
naire. Pour pallier les difficultes de ce systeme, les informaticiens ont defini une date 
d'origine arbitraire, correspondant au l er Janvier 1970 00 h 00 m 00 s. A partir de cette 
date, le temps est compte en secondes. Ce nombre de secondes est nomme timestamp, ou 
instant UNIX. 



Timestamp negatif 

L'inconvenient de ce systeme est de fournir des timestamps negatifs pour les dates anterieures a I'origine. 
De plus, sous Windows, aucune des fonctions de date de PHP n'accepte comme parametres les instants 
UNIX negatifs, alors que les serveurs sous Linux les autorisent. 
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La fonction timet), que vous utiliserez souvent par la suite, retourne le timestamp de 
l'instant present. Cette valeur n'est pas affichee au visiteur du site. Elle sert seulement 
d'intermediaire sous-jacent pour calculer des durees et determiner des dates futures ou 
passees. Le timestamp est alors passe a d'autres fonctions, qui realisent l'affichage en clair 
de la date desiree. Un timestamp permet par ailleurs de stocker plus facilement une date 
a un seul nombre et constitue le moyen le plus stir pour conserver une date dans une base 
de donnees. 

L'exemple 8-1 montre la maniere d'utiliser cette fonction pour afficher le timestamp en 
cours directement avec la fonction timeO (repere Q) ainsi que celui de dates futures 
(repere ©) et passees (repere ©). II suffit pour cela d'ajouter ou d'enlever le nombre de 
secondes desire. Pour calculer le nombre d'heures ou de jours correspondant au times- 
tamp de l'instant en cours, il suffit de diviser la valeur donnee par la fonction timet ) par 
3 600 pour le nombre d'heures (repere ©) et par 3 600 puis 24 pour le nombre de jours 
(repere ©). 



Decalage horaire 

Le timestamp retourne par la fonction timet ) est bien sur celui qui est calcule cote serveur. II n'est pas 
forcement identique a celui du poste client. II faut done tenir compte du decalage horaire eventuel. 



Exemple 8-1 . La fonction time() 



<?php 

echo "A cet instant precis 



e timestamp est 



timet ),"<br />"; <— Q 



echo "Dans 23 jours le timestamp sera : ", 

*"<br />"; ^© 

echo "II y a 12 jours le timestamp etait : 

echo"Nombre d'heures depuis le 1/1/1970 = 

echo"Nombre de jours depuis le 1/1/1970 = 

?> 



timet )+23*24*3600, 

", timet )-12*24*3600,"<br />"; <—Q 
'.roundttimet)/ 3600), "<br />"; <-© 
',round(time()/3600/ 24),"<br />";<-© 



Le resultat obtenu a l'instant du test est le suivant 



A cet instant precis le timestamp est : 1224522240 
Dans 23 jours le timestamp sera : 1226509440 
II y a 12 jours le timestamp etait : 1223485440 
Nombre d'heures depuis le 1/1/1970 = 340145 
Nombre de jours depuis le 1/1/1970 = 14173 



Les fonctions abordees dans les sections qui suivent vous permettront de trouver a quelle 
date precise ce test a ete effectue. 

La fonction microtimet) fournit egalement le nombre de secondes et de microsecondes 
de l'instant en cours, mais en retournant non pas un nombre decimal mais une chaine de 
caracteres commencant par le nombre de microsecondes suivi du nombre de secondes. 
Cela est du au manque de precision des nombres decimaux de type double, qui ne 
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permettent pas d'afficher suffisamment de chiffres significatifs. II faut done extraire les 
renseignements utiles de la chaine a l'aide de la fonction substr( ), qui decoupe la chaine 
en deux sous-chaines. 

Si le nombre de microsecondes ne presente aucun interet pour l'utilisateur, il se revele en 
revanche tres utile pour calculer des temps d'execution. Le script de l'exemple 8-2 extrait 
les renseignements fournis par la fonction microtime()(reperes O et ©)• H calcule 
ensuite la duree d'execution du script apres l'ajout d'une boucle (repere ©), destinee a 
augmenter le temps d'execution. Cette duree etant inferieure a la seconde, le calcul ne se 
fait que sur le nombre de microsecondes. Pour les durees plus longues, il faudrait calculer 
le nombre de secondes et de microsecondes. 

Si le nombre final est inferieur au nombre initial, la duree calculee est negative et done 
fausse. II est toutefois possible d'obtenir un resultat juste dans tous les cas en utilisant 
1' operate ur conditionnel ?, comme dans le code suivant : 

| $duree=($duree>0) ? ($duree) : (1000000+$duree) ; 

Exemple 8-2. Calcul de duree en microseconde 

<?php 

//La fonction microti me ( ) 

$temps = microtimet ) ; 

echo "Chaine microtime = ", $temps,"<br />"; 

//Lecture du nombre de microsecondes 

$microsec= (integer)substr($temps,2,6) ; <— O 

//Lecture du nombre de secondes 

$sec - substr($temps,ll,10); <— Q 

echo "A la microseconde pres le timestamp est : $sec.$microsec secondes<br />"; 

echo "Le nombre de microseconde est: Smicrosec us<br />"; 

echo "Le nombre de seconde est: $sec secondes<br />"; 

$x=0; 

//Boucle pour perdre du temps 

for($i=0;$i<200000;$i++) <-© 

{$x+=$i;} 

//Temps final 

$tempsfin=microtiine( ) ; 

$microsecfin = substr($tempsfin,2,6) ; 

$duree=$microsecfin-$microsec; 

$duree=($duree>0) ? ($duree) : (1000000+Sduree) ; 

echo "Temps d'execution du script=", $duree," microsecondes"; 

?> 

L'exemple retourne le resultat suivant : 

Chaine microtime = 0.76500300 1224522453 

A la microseconde pres le timestamp est : 1224522453.765003 secondes 

Le nombre de microsecondes est: 765003 us 

Le nombre de secondes est: 1224522453 secondes 

Temps d'execution du script=28562 microsecondes 
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Ralentir un script 

Ce n'est generalement pas le but d'un programmeur, mais il peut etre utile de retarder I'execution d'un 
script. II suffit d'appeler la fonction sleepdnteger N), qui cree un delai de N secondes. Pour creer 
undelaien microseconde, il faut utiliser la fonction usleep( integer N) en indiquant le nombre de micro- 
secondes N. 



Definir une date 



La fonction time( ) ne donne que le timestamp de l'instant en cours et se montre inadap- 
tee pour creer des dates determinees anterieures ou posterieures. Pour cela, il faut avoir 
recours a la fonction mktime( ), dont la syntaxe est la suivante : 



int mktimetint heure, 
**int ete) 



int minute, int seconde, int mois, int jour, int annee. 



La fonction retourne le timestamp correspondant a la date definie par les valeurs entieres 
passees en parametres. La signification de ces valeurs est evidente, a l'exception de la 
derniere, qui doit valoir 1 pour l'heure d'hiver, pour l'heure d'ete et - 1, valeur par 
defaut, si vous ne savez pas. Comme explique precedemment, il est impossible de definir 
des dates anterieures au l er Janvier 1970 sur un serveur sous Windows. 

Pour gerer des dates GMT, vous disposez de la fonction gmmktime( ), dont la syntaxe est la 
suivante : 



int gmmktimetint heure, int minute, int seconde, 
**int ete) 



int mois, int jour, int annee, 



Cette fonction retourne le timestamp correspondant a la date GMT. Elle peut servir a 
corriger la date et l'heure fournies par un serveur heberge, par exemple, aux Etats-Unis. 
Les valeurs passees en parametres sont identiques a celles de la fonction mkt1me( ). 

L'exemple 8-3 definit une date passee a l'aide de la fonction mktimeO (repere O) et 
calcule la duree ecoulee jusqu'a l'instant present (repere ©). Ces operations sont repe- 
tees pour une date future (reperes © et ©). La fonction gmmktimeOmesure ensuite le 
decalage horaire du serveur par rapport a l'heure GMT (reperes et ©). 

Exemple 8-3. Definition de dates et calcul de durees 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Dates et durees</title> 
</head> 
<body> 
<div> 
<?php 
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//la fonction mktimeO 

$timepasse= mktime(12,5,30,5,30,1969) ; <— Q 

$timeaujour - timet ) ; 

Sduree = $timeaujour-$timepasse; <— © 

echo "Entre le 30/05/1969 a 12h05m30s et maintenant il s'est ecoule" ,$duree, 

*»" secondes <br />"; 

echo "Soit " ,round($duree/3600) , " heures <br />"; 

echo "Ou encore " ,round($duree/3600/24) , " jours <br />"; 

$timefutur = mktime(12,5, 30, 12,25, 2008) ; 

$noel = $timefutur-$timeaujour; <— © 

echo "Plus que ",$noel, "secondes entre maintenant et Noel, soit ", 

*round($noel/3600/24)," jours, Patience! <br />";<^© 

//la fonction gmmktimeO 

Stimepassegmt = gmmktime(12,5,30,5,30,1969) ; <— 

echo "Timestamp serveur pour le 30/5/1969= " ,$timepasse, "<br />"; 

echo "Timestamp GMT pour le 30/5/1969= ", Stimepassegmt, "<br />"; 

echo "Decalage horaire = " ,$timepasse-$timepassegmt, " secondes<br />";<— 

?> 

</div> 

</body> 

</html> 

L'exemple retourne le resultat suivant sur un serveur Linux : 

Entre le 30/05/1969 a 12h05m30s et maintenant il s'est ecoule 1243146454 secondes 

Soit 345318 heures 

Ou encore 14388 jours 

Plus que 5679146secondes entre maintenant et Noel, soit 66 jours, Patience! 

Timestamp serveur pour le 30/5/1969= -18622470 

Timestamp GMT pour le 30/5/1969= -18618870 

Decalage horaire = -3600 secondes 



Sur un serveur Windows, le meme script affiche l'erreur suivante, qui confirme que les 
timestamps negatifs n'y sont pas admis : 

Warning: mktimeO: Windows does not support negative values for this function in c:\ 
eyrolles\php5\c8dates\date8.3.php on line 11 



Verifier une date 



Dans un formulaire complete par un visiteur, il n'est pas rare que celui-ci indique une 
date, ne serait-ce que sa date de naissance. Meme si une expression reguliere peut vous 
permettre de verifier si la saisie repond a un format impose, par exemple JJ/MM/AAAA, 
elle ne peut verifier si la date indiquee existe ou si le nombre des jours et celui des mois 
sont inverses. 
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II peut etre opportun dans de tels cas d'utiliser la fonction checkdate( ), dont la syntaxe est 
la suivante : 

boolean checkdatednt mois, int jour, int annee) 

La fonction checkdate( ) retourne une valeur booleenne TRUE si la date existe et FALSE dans 
le cas contraire. 

Dans l'exemple 8-4, la chaine de caracteres contenue dans la variable $_P0ST["date"] 
apres l'envoi du formulaire est decomposee grace a la fonction explodeO. Chaque 
element de la date (jour, mois, annee) est recupere dans un element de tableau (repere Q). 
Les elements $tabdate[l], $tabdate[0] et $tabdate[2] contiennent respectivement le jour, 
le mois et l'annee saisies par l'utilisateur. Ces donnees sont ensuite passees comme argu- 
ments a la fonction checkdateO dans l'ordre « mois, jour, annee » pour respecter la 
syntaxe de la fonction (repere ©). Un message s'affiche selon que la date est valide ou 
non (reperes © et ©). 

Exemple 8-4. Formulaire de verification de date 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Validation de date</title> 
</head> 

<body> 

<form method="post" action="<?= $_SERVER["PHP_SELF"] ?>" > 

<fieldset> 

<legend>Entrez votre date de naissance sous la forme JJ/MM/AAAA</legend> 

<input type="text" name="date" /> 

<input type="submit" value="Envoi "/> 

</fieldset> 

</form> 

<?php 

//checkdate 

if(isset($_POST["date"])) 

{ 

$date=$_POST["date"]; 

$tabdate=explode("/",$date) ; 

if(!checkdate($tabdate[l],$tabdate[0],$tabdate[2]) ) {echo "<hr /> 

*»La date $date n'est pas valide. Recommencez! <hr />";} 

else {echo "<h3> La date $date est valide. Merci !</h3>" ; } 



?> 

</body> 

</html> 
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^ Validation de date - Mozilla Firefox 



■M°).|-aM 



Fichier Edition Affichage Historique Marque-pages Outils ? 

tf+iptjj T O ffr ( ■_. I http;//www,funhtml,com/php5/Cadate5/date3,4,php ffi T | ||G| T 



[Valid] Markup Validation of http://... x ^ 



Validation, de date 



E 



Entrez votre date de naissance sous la forme JJ/MM/'AAAA - 



29/02/2012 



Envoi 



La date 29/02/2012 est valide. Merci! 



Figure 8-1 

Le formulaire de verification des dates 

Afficher une date en clair 

La fonction dateO permet d'afficher une date selon des parametres plus lisibles qu'un 
timestamp UNIX. Sa syntaxe est la suivante : 

string date(string format_de_date, [int timestamp]) 

Elle retoume une chaine contenant des informations de date dont la mise en forme est 
definie par des caracteres speciaux (voir leur signification au tableau 8-1). La date retour- 
nee correspond a celle du timestamp passe en deuxieme parametre ou, si ce dernier est 
omis, a celle de 1' instant en cours. 

Pour afficher un des caracteres speciaux du tableau 8-1 independamment de sa fonction 
de formatage, il faut le faire preceder d'un antislash. Par exemple, \h affiche le caractere 
« h » et non le nombre d'heure. Pour afficher les caracteres « n » et « t », il faut ecrire \\n 
et \\t car \n et \t sont employes pour le saut de ligne et la tabulation. 

Par exemple, pour obtenir 1' affichage : 

Aujourd'hui Monday, 20 October 2008 il est 23:36:27 



vous ecnvez : 

echo "Aujourd'hui ", dated, d F Y \i\l \e\s\\t H:i:s "); 

La fonction dateO tient compte de l'heure d'ete. 

L'exemple ci-dessous utilise la fonction date( ) pour des timestamps futurs (repere Q) et 
passes (repere ©) : 

I echo "Dans 40 jours nous serons le ".dated , d F Y H:i :s" , timet )+40*3600*24) ; <—Q 
echo "II y 24 jours nous etions le ".dated, d F Y H:i :s" .timet ) -24*3600*24) , 
^"<br />": ^© 
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L'exemple retourne le resultat suivant : 



Dans 
11 y 


40 jours 
24 jours 


nous 
nous 


serons le Saturday, 29 November 2008 22:38:52 
etions le Friday, 26 September 2008 23:38:52 


Tableau 8-1 - Caracteres de definition du format d'affichage 


Caractere de definition 


Definition et resultat affiche 


y 








L'annee en deux chiffres (05 pour 2005) 


Y 








L'annee en quatre chiffres (2005) 


L 








Affiche 1 si l'annee est bissextile et sinon. 


m 








Le mois en deux chiffres de 01 a 12 


n 








Le mois en un ou deux chiffres de 1 a 12 


M 








Le mois en trois lettres (en anglais) 


F 








Le mois en toutes lettres (en anglais) 


t 








Le nombre de jours du mois de 28 a 31 


d 








Le jour du mois en deux chiffres de 01 a 31 


J 








Le jour du mois en un chiffre de 1 a 31 


D 








Le jour de la semaine en trois lettres (en anglais) 


1 (petit L) 






Le jour de la semaine en toutes lettres (en anglais) 


w 








Le jour de la semaine code de pour dimanche a 6 pour samedi 


S 








Affiche le suffixe anglais « th » ou « nd » apres les chiffres du jour. 


z 








Le jour de l'annee de a 366 


g 








Les heures de 1a 12 (avec AM et PM) 


h 








Les heures de 01 a 12 (avec AM et PM) 


G 








Les heures de a 23 


H 








Les heures sur deux chiffres de 00 a 23 


a 








Ajoute « am » pour le matin ou « pm » pour I'apres-midi. 


A 








Ajoute « AM » pour le matin ou « PM » pour I'apres-midi. 


i Les minutes en deux chiffres de 00 a 59 


s 








Les secondes en deux chiffres de 00 a 59 


U 








Affiche le timestamp UNIX. 


Z 








Donne le decalage horaire par rapport au temps GMT ou UTC en seconde, de -43 200 
a 43 200. 


T 








Affiche la ville significative du fuseau horaire, par exemple « Paris, Madrid ». 


I 








Affiche pendant I'heure d'hiver et 1 pendant I'heure d'ete. 


r 








Affiche la date complete au format RFC 822, par exemple: « Sun, 1 3 Apr 2003 22:34:46 
+0200 ». 


B 








Heure Internet Swatch : invention de la societe Swatch selon laquelle 24 heures sont 
divisees en 1 000 elements nommes « beats ». Par exemple, midi vaut 500 beats. 
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La fonction dateO permet de recuperer des informations numeriques individuelles en 
n'utilisant qu'un seul caractere dans la chaine de formatage. 

Par exemple : 

$numjour = dateC'w"); 
recupere le numero du jour de la semaine, de pour dimanche a 6 pour samedi ; 

$nummois=date( "n") ; 
recupere le numero du mois de 1 a 12 ; 

$bissext=date("L") ; 
recupere la valeur 1 si l'annee est bissextile et dans le cas contraire. 
L'exemple ci-dessous : 

I$bissext=(bool) dated."); 
if($bissext) {echo "L'annee " ,date("Y" ) , " est bissextile";} 
else {echo "L'annee " ,date("Y" ) , " n'est pas bissextile";} 

retourne le resultat suivant : 

L'annee 2008 est bissextile 

La fonction getdateQ 

Contrairement a la fonction dateO, getdateO ne retourne pas une chaine de caracteres 
mais un tableau contenant toutes les informations de date. 

Sa syntaxe est la suivante : 

array getdate([int timestamp] ) 

Si le parametre timestamp est omis, la fonction getdateO retourne les informations sur la 
date en cours. 

Le tableau retourne est un tableau associatif, dont les cles sont fournies au tableau 8-2. 
Tableau 8-2 - Cles du tableau retourne par la fonction getdateQ 

Cle Description 

wday Le jour de la semaine sous forme d'entier de (dimanche) a 6 (samedi) 

weekday Le jour de la semaine sous forme de chaine (en anglais) 

mday Le jour du mois sous forme d'entier de a 31 

mon Le mois sous forme d'entier de 1 a 12 

month Le mois sous forme de chaine (en anglais) 

year L'annee en entier sur 4 chiffres 

hours L'heure de a 23 
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Tableau 8-2 - Cles du tableau retourne par la fonction getdatef) (suite) 

minutes Les minutes de a 59 

seconds Les secondes de a 59 

yday Le jour de I'annee de 1 a 366 

Le timestamp correspondant a la date 

La recuperation des informations se fait en deux temps, l'appel de la fonction getdate( ) 
puis la lecture des elements du tableau retourne. 

L'exemple ci-dessous : 

I$jour = getdatet ) ; 
echo "Aujourd'hui {$jour["weekday"]) ($jour["mday"]) {$jour["month"]} 
*»{$jour["year"]}"; 

affiche le resultat suivant : 

Aujourd'hui Monday 20 October 2008 



Afficher la date en frangais 

Comme vous venez de le voir, les fonctions getdateO et dateO affichent les noms des 
jours et des mois en anglais. Une premiere maniere d'obtenir un affichage en frangais 
consiste a utiliser ces fonctions d'une maniere detournee. 

Vous creez pour cela deux tableaux indices, $semai ne et $moi s, destines a contenir respec- 
tivement les noms des jours et des mois en frangais. Pour un site multilingue, vous 
pouvez creer autant de tableaux que de langues desirees. II vous suffit ensuite de recupe- 
rer les donnees numeriques du jour de la semaine, avec dateC'j") ou $tab["wday"] si 
$tab=getdate(), puis du numero de mois, avec dateC'n") ou $tab["mon"], qui vous servi- 
ront d'indice pour lire le jour et le mois a partir des tableaux $semai ne et $moi s. 

Pour obtenir 1' affichage suivant : 

Aujourd'hui Lundi 20 Octobre 

au lieu de « Monday 20 October », vous ecrivez : 

I$jour = getdatet ) ; 
echo "Aujourd'hui ", $semaine[$jour[ 'wday ']] , $jour["mday"] , 
^»$mois[$jour['mon']] ,"<br>"; 



ou : 



echo "Aujourd'hui " ,$semaine[date( 'w' )] , dateC'd"), $mois[date( 'n' )] ; 
echo $semaine[date( 'w' )] ,$mois[date( 'n' )] ; 
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L'exemple 8-5 donne l'ensemble du code necessaire pour afficher une date en francais 
avec les fonctions getdateO (repere Qt et date( )(repere @). 

Exemple 8-5. Affichage d'une date en francais avec date() et getdateO 

<?php 

//Date en francais 

$jour = getdate( ) ; 

echo "Anglais: Aujourd'hui {$jour["weekday"]} {$jour["mday"]}{$jour["month"]} 

*{$jour["year":i} <br />"; 

$semaine = arrayC dimanche "," lundi "," mardi "," mercredi "," jeudi ", 

**" vend red i "," samedi "); 

$mois =array(l=>" Janvier "," fevrier "," mars "," avril "," mai "," juin ", 

*»" juillet "," aout "," septembre "," octobre "," novembre "," decembre "); 

//Avec getdate( ) 

echo "Frangais: Avec getdateO : Aujourd'hui " ,$semaine[$jour[ 'wday ' ]] , 

*»$jour[ 'mday ' ] , $mois[$jour[ 'mon' ]] , $jour[ 'year' ] , "<br />";<— O 

//Avec dateO 

echo " Francais: Avec dateO : Aujourd'hui ", $semaine[date( 'w' )] ," ", 

*date('j')," ", $mois[date('n')], date( 'Y' ) , "<br />";<^© 

?> 

L'exemple retourne le resultat suivant : 

Anglais: Aujourd'hui Monday 20 October 2008 

Francais: Avec getdateO : Aujourd'hui lundi 20 octobre 2008 

Francais: Avec dateO : Aujourd'hui lundi 20 octobre 2008 

L' affichage de la date en francais se retrouvant frequemment sur toutes les pages d'un 
meme site, il est dommage de reecrire le meme code dans chaque page. Dans un but de 
modularisation du code, il est preferable de creer une fonction personnalisee. 

C'est l'objet de l'exemple 8-6, qui cree une fonction datefrO pour afficher le jour et le 
mois en francais et un parametre $njour pour afficher la date situee un nombre de jours 
donne apres la date en cours. Ce parametre ayant par defaut la valeurO, l'appel de 
datef r( ) sans parametre affiche la date du jour. 

Exemple 8-6. Creation d'une fonction de date en francais 

<?php 
//it************************************************ 

//Definition d'une fonction d'affichage en frangais 
//*************************************•*********** 

function datef r($njour=0) 
{ 

$timestamp=time() + $njour*24*3600; 

Ssemaine = arrayC dimanche "," lundi "," mardi "," mercredi "," jeudi ", 

*•" vendredi "," samedi "); 

$mois =array(l=>" Janvier "," fevrier "," mars "," avril "," mai "," juin ", 

*»" juillet "," aout "," septembre "," octobre "," novembre "," decembre "); 
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$chdate= $semaine[date( 'w' ,$timestamp)] ." " .date( ' j ' ,$timestamp) . " ". 

*»$mois[date( 'n' , Stimestamp)] ; 

return Schdate; 
} 
?> 

Vous pouvez utiliser cette fonction dans n'importe quel script en l'incluant avec incl ude( ). 

Par exemple, le code suivant : 

|<?php 
incl ude("date8.6.php" ) ; 
echo "Aujourd'hui : " .datef r( ) ,"<br />"; 
echo "Dans 12 jours : ", datef r(45) , "<br />"; 
?> 



affiche, comme le script 8-5, le resultat suivant 



Aujourd'hui : lundi 20 octobre 
Dans 45 jours : jeudi 4 decembre 



Proche de la fonction dateO par son fonctionnement, la fonction strftimeO permet 
d'afficher, en anglais, les informations de date composees a l'aide des caracteres speciaux 
du tableau 8-3. Sa syntaxe est la suivante : 

string strftimetstring format_de_date, int timestamp) 

Tableau 8-3 - Caracteres de formatage de la fonction strftimeQ 



Caractere 


1 

Description 


%a 


Jour de la semaine abrege 


%k 


Jour de la semaine en entier 


%b 


Mois abrege 


%B 


Mois en entier 


%c 


Affiche la date et I'heure au format local (exemple 24/ 04/2005 1 5:32:52 si la langue est le frangais). 


K 


Numero du siecle 


%d 


Jour du mois numerique de 01 a 31 


%0 


Equivalent de I'ensemble "Md%y" 


le 


Jour du mois de 1 a 31 precede d'une espace 


%h 


Equivalent de %b 


%W 


Nombre d'heures de 00 a 23 


%\ 


Nombre d'heures de 00 a 1 2 (voir Xp pour afficher am ou pm) 


%i 


Numero du jour de I'annee de 1 a 366 


%m 


Numero du mois de 1 a 12 
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Tableau 8-3 - Caracteres de formatage de la fonction strftime() (suite) 

%H Nombre de minutes de a 59 

%n Saut de ligne 

%p Affiche « am » ou « pm » selon I'heure 

%S Nombre de secondes 

%t Equivalent de la tabulation It 

%J Equivalent de I'ensemble "%H:«M:«S" 

%u Le jour de la semaine de 1 pour lundi a 7 pour dimanche (attention cette notation est differente de 

celle des fonctions date et getdate). 

%W Numero de la semaine (la premiere semaine commencant avec le premier dimanche de l'annee, 

les jours qui precedent ne comptent pas). 

%\l Numero de la semaine ISO de 01 a 53. La premiere semaine est celle qui a plus de 4 jours ; le lundi 

est le premier jour de la semaine. 

%vi Le jour de la semaine de pour dimanche a 6 pour samedi 

%M Numero de la semaine (la premiere semaine commengant avec le premier lundi de I'annee, les 

jours qui precedent ne comptent pas). 

%x Affiche la date au format local defini par setlocalet ). Exemple J J/ MM/AAAA. 

XX Affiche I'heure au format local defini par setlocalet). Exemple HH:MM:SS. 

%y L'annee sur deux chiffres de 00 a 99 

%1 L'annee sur quatre chiffres 

%l Les villes correspondant au fuseau horaire 

%% Affiche le caractere « % » seul. 

La fonction gmstrftime( ) fournit les memes resultats en heure GMT. Pour afficher Pequi- 
valant de ces dates en francais (ou dans une autre langue), il sufflt d'utiliser auparavant la 
fonction setl ocal e( ) selon la syntaxe suivante : 

string setlocaletint constante, string lang) 

La constante prend les valeurs LC_ALL ou LCJTIME dans le contexte temporel et pour para- 
metre 1 ang le code de la langue desiree, par exemple "f r" pour le francais. 

Pour adapter automatiquement Paffichage de la date a la langue du navigateur, qui n'est 
pas forcement celle du pays, vous pouvez recuperer ce parametre de langue a Paide de la 
variable $_SERVER["HTTP_ACCEPT_LANGUAGE"]. 

L'exemple 8-7 utilise cette propriete pour afficher la date en francais puis en italien apres 
avoir configure le navigateur dans cette langue. L'utilisation conjointe des fonctions 
strftimeO et setlocalet) est tres pratique, mais il vous appartient de verifier qu'elles 
marchent sur votre serveur distant, en particulier la fonction setl ocal et ), car ce n'est pas 
toujours le cas. 
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La langue est d'abord definie avec le parametre "f r" (repere Q 1 - Le script affiche ensuite 
en francais la date complete en heure locale (repere ©) puis en GMT (repere ©). La 
variable $1 ang recupere la valeur prioritaire du navigateur (repere 0), puis l'affichage se 
fait en italien (repere 0). 

Exemple 8-7. Affichage de la date avec setlocaleO et strftime() 

<?php 
//****************************** 

//Avec setlocaleO et strftimeO 



****************************** 



h m m %S s %r 
Vt %W h M m %S 



II 

echo "fonction strftimeO et setlocaleO <br />"; 

setlocale (LC_ALL, "fr");<-© 

echo "Francais : Aujourd'hui " .strftimeO Ik Id. %B Vi %H 

*"<br />" ; ^© 

echo "Francais GMT : Aujourd'hui " ,gmstrftime(" %K %d %5 

^•time()),"<br />"; ^© 

Slang = $_SERVER["HTTP_ACCEPT_LANGUAGE"] ; <-© 

echo "Langue utilisee par le navigateur = ", Slang, "<br />"; 

setlocale (LC_ALL, Slang); 

echo "Italiano : ".strftimeO Ik %d IB %Y %H h m m %S s" .timet )), "<br 

?> 

Le script retourne le resultat suivant : 



.timeO), 
s 11" , 

/>";<HD 



Fonctions strftimeO et setlocaleO 

Frangais : Aujourd'hui vendredi 24 octobre 2008 23 h 53 m 46 s Paris, Madrid (heure 

d'ete) 

Frangais GMT : Aujourd'hui vendredi 24 octobre 2008 21 h 53 m 46 s Paris, Madrid 

Langue utilisee par le navigateur - it.fr ;q=0 . 5 

Italiano : venerdi 24 ottobre 2008 23 h 53 m 46 s 



Les fonctions de calendrier 

L'extension nommee calendar installee par defaut dans PHP propose quelques autres 
fonctions, plus anecdotiques que les precedentes, comme la fonction easter_date(), qui 
retourne le timestamp du jour de Paques de l'annee passee en parametre et dont la 
syntaxe est la suivante : 

int easter_date(int annee) 

Cette fonction permet de fabriquer un calendrier complet pour une annee donnee, les 
autres fetes religieuses des mois suivants etant calculees par rapport a la date de Paques, 
ou encore de prevoir vos week-ends des annees futures. 

En ecrivant, par exemple : 

echo "Paques 2009 sera le : ",date( "d F Y", easter_date(2009)) ; 
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vous obtenez l'affichage suivant : 



Paques 2009 sera le : 12 April 2009 



Le calendrier actuel, dit gregorien, a ete instaure en 1582 en Europe continentale et 
en 1753 au Royaume-Uni et dans le Commonwealth. Auparavant, c'etait le calendrier 
Julien, instaure par Jules Cesar, qui gouvernait le temps. L'usage de ces calendriers 
permet de gerer des dates anterieures a l'epoch UNIX (origine des timestamps au 
l er Janvier 1970). 

Pour contourner le probleme de non-prise en charge d'une date anterieure a 1970 sous 
Windows, par exemple, vous pouvez utiliser des fonctions qui font appel au calendrier 
Julien. La fonction gregoriantojcK ), dont la syntaxe est la suivante : 

int gregoriantojd ( int mois, int jour, int annee) 

retourne le nombre de jours du calendrier Julien. Utilisee comme parametre pour d'autres 
fonctions, elle se revele fort utile. 

L' exemple suivant : 

j divers jddayofweek ( int jour_julien, int mode) 

retourne le jour de la semaine sous la forme d'un entier de (dimanche) a 6 (samedi) si 
le parametre mode vaut et sous la forme d'une chaine de caracteres en anglais s'il vaut 1. 
Cette fonction vous permet, comme a l'exemple 8-8, de connaitre la date de naissance 
d'une personne nee avant le l er Janvier 1970 ou le jour d'un evenement historique dont 
vous saisissez le jour du mois, le mois et l'annee dans un formulaire (reperes Q, © et ©). 
Dans cet exemple, vous utilisez en outre un tableau pour traduire les jours de la semaine 
en francais (repere ©). 

Exemple 8-8. Recherche d'un jour de semaine anterieur a 1970 

<!D0CTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 

"http://www.w3.org/TR/html4/strict.dtd"> 

<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l"> 

<title>Quel jour c'etait?</title> 

</head> 

<body> 

<hl> Quel jour c'etait? </hl> 

<form method="post" action="<?= $_SERVER["PHP_SELF"] ?>" > 

<fieldset> 

<legend>Quel jour c'etait? </legend> 

Jour   <input type="text" name="jour" /><br><— O 

Mois  <input type="text" name="mois" /><br> <— © 

Annee<input type="text" name="an" /><br> <— Q 
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<input type=" submit" name="envoi " val ue="Calculer"/Xbr> 

</fieldset> 

</form> 

<?php 

//Utiliser un formulaire de saisie de date et dormer le jour de la semaine 

if(isset($_POST["envoi"])) 

{ 

//Recuperation des valeurs 

$jour= $_P0ST["jour"]; 

$mois= $_P0ST["mois"]; 

$an= $_P0ST["an"]; 

//Transformation Gregorien/Jul ien 

$jd = gregoriantojd($mois,$jour,$an) ; 

//Traduction en frangais 

$semaine = array( "Sunday"=>" dimanche " , "Monday"=>" lundi " , "Tuesday"=>" mardi 

*» "Wednesday "=>" mercredi " , "Thursday"=>" jeudi " , "Friday"=>" vendredi ", 

^»"Saturday"=>" samedi ");<— O 

//Affichage du resultat 

echo "<h2>Le $jour/$mois/$an etait un " ,$semaine[jddayofweek($jd,D] ,"</h2>" ; 

} 

?> 

</body> 

</html> 



;OiM^«^^^ 
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Figure 8-2 

Calcul d'unjour de semaine anterieur a 1970 



D'autres fonctions anecdotiques fournissent les mois des calendriers julien, juif ou revo- 
lutionnaire, qui permettent de comprendre, par exemple, pourquoi la revolution russe, 
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dite d'octobre 1917 dans le calendrier Julien en vigueur alors en Russie, a eu lieu en 
novembre dans le calendrier gregorien en vigueur en France, ou de savoir quel jour a eu 
lieu le coup d'Etat de Bonaparte le 18 Brumaire an VIII (9 novembre 1799) ou la chute 
de Robespierre le 9 Thermidor an II (27 juillet 1794). 

Memo des fonctions 

bool checkdate (int mois, int jour, int annee) 

Verifie la validite de la date definie a I'aide des parametres moi s, jour, annee. 

string datetstring format, int timestamp) 

Retourne en clair la date composee des informations indiquees dans la chaine de formatage (voir le tableau 8-1). 

array getdatetint timestamp) 

Retourne un tableau associatif contenant toute information de date correspondant au timestamp (voir le tableau 8-2). 

array gettimeofday( ) 

Retourne un tableau associatif dont les cles sont sec, usee, mi nuteswest et dstti me correspondant respectivement au 
nombre de secondes et de microsecondes et au decalage horaire par rapport a I'heure GMT. L'element de cle dstti me 
vaut 1 pour I'heure d'hiver et en ete. Les valeurs sont celles du serveur. 



string gmdate(string format, int timestamp) 
Identique a la fonction date( ) mais avec des donnees GMT 

int gmmktimetint heure.int minute, int seconde, int mois, int jour, int annee, int hiver) 

Retourne le timestamp GMT correspondant a Nnstant defini par les parametres. L'entier hiver vaut 1 pour I'heure d'hiver 
et sinon. 

string Gmstrftime(string format, int timesatmp) 

Identique a strftimet ) mais en heure GMT 

string tnicrotime( ) 

Retourne une chaine composee du nombre de microsecondes suivi d'une espace puis du nombre de secondes de 
I'instant present. 

int mktimetint heure.int minute, int seconde, int mois, int jour, int annee, int hiver) 

Retourne le timestamp (en heure locale du serveur) correspondant a I'instant defini par les parametres. L'entier hiver 
vaut 1 pour I'heure d'hiver et sinon. 

string Strftimetstring format, int timestamp) 

Retourne un tableau associatif contenant toutes les informations de date correspondant au timestamp (voir le tableau 8-3). 

int timet ) 

Retourne le timestamp de I'instant en cours sur le serveur. 
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Exercices 



Exercice 1 

Apres avoir consults le resultat affiche par l'exemple 8-1, determinez la date et l'heure de 
l'execution de ce script. 

Exercice 2 

Calculez votre age a l'instant en cours a la seconde pres. 

Exercice 3 

Verifiez si la date du 29 fevrier 1962 a existe. 

Exercice 4 

Quel jour de la semaine etait le 3 mars 1993 ? Affichez le resultat en francais. 

Exercice 5 

Affichez toutes les annees bissextiles comprises entre 2005 et 2052. 

Exercice 6 

Determinez quel jour de la semaine seront tous les premier Mai des annees comprises 
entre 2005 et 2010. Si le jour est un samedi ou un dimanche, affichez le message 
« Desole !». Si le jour est un vendredi ou un lundi, affichez « Week-end prolonge !». 

Exercice 7 

L'Ascension est le quarantieme jour apres Paques (Paques compris dans les 40 jours). 
Calculez les dates de l'Ascension pour les annees 2005 a 2010. 
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La programmation objet 



Avant la version 5, PHP etait loin d'etre un langage de programmation orientee objet 
(POO), en comparaison de Java ou de C++, dont, il est vrai, la destination n'est pas la 
meme. Dans ASPNet, destine typiquement au Web, toute action de programmation 
entraine la creation et la manipulation d'objets preexistants. Du fait de cette lacune de 
PHP 4, les projets de grande envergure le delaissaient au profit d'ASPNet ou de JSP. 

Les concepteurs de PHP 5 ont du effectuer une refonte totale du modele objet tres 
sommaire de PHP 4 pour le rendre plus proche de celui de Java. Sans devenir un langage 
de POO a part entiere, PHP 5 fournit neanmoins desormais les outils necessaires a ceux 
qui souhaitent choisir cette orientation. La manipulation d'objets n'est pas une obligation 
dans le plupart des cas mais pourrait devenir une necessite pour de gros projets. 

D'ores et deja, l'extension SimpleXML, qui permet de gerer les documents XML (voir le 
chapitre 19) ne fournit qu'une approche objet et aucune fonction, contrairement aux autres 
extensions. De son cote, la base SQLite est certes encore accessible via une methode 
procedurale, mais elle offre en parallele un acces oriente objet, dont l'utilisation est 
recommandee. MySQL est egalement engage dans cette voie. C'est done une tendance 
lourde de PHP 5. Meme si on peut en discuter, il parait evident qu'elle ne fera que 
s'accentuer. 

Ce chapitre aborde non pas l'utilisation d'objets predefinis mais l'ensemble des outils 
qui permettent au programmeur de creer ses propres objets. 

De meme que vous ecrivez une fonction pour effectuer une tache repetitive, vous avez un 
interet a creer des objets pour gerer des projets complexes. Un objet correspond a la mode- 
lisation d'une entite reelle ou abstraite, par exemple, un client, 1' article qu'il commande 
ou la commande elle meme. La POO permet de modulariser le code des scripts en decom- 
posant les donnees a traiter en differentes entites, chacune etant representee par un type 
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d'objet. Elle offre de surcroit la possibility de reutiliser des classes deja creees grace au 
mecanisme de l'heritage, qui permet de creer de nouvelles classes a partir des classes 
existantes en leur ajoutant de nouvelles fonctionnalites. 

II ne s'agit pas ici, en un seul chapitre, d'aborder tous les aspects de la POO. Si vous 
voulez approfondir vos connaissances sur le sujet, vous pourrez vous reporter utilement 
au livre de Bertrand Meyer, Conception et programmation orientees objet, aux editions 
Eyrolles, qui constitue la bible sur le sujet. 



Terminologie des objets 

Si vous avez deja pratique d'autres langages de programmation reellement orientes objet, 
les notions de classe et d'objet vous sont familieres. Vous pouvez done passer directement 
a la section suivante, qui vous permettra de voir la maniere d'implementer les classes et 
les objets dans PHP. 

La terminologie propre aux classes et aux objets est tres variable selon les sources. Pour 
cette raison, il apparait utile de preciser le vocabulaire qui sera employe dans ce chapitre. 

Un objet informatique est la representation d'un objet reel au sens large. II peut aussi 
bien s'agir d'un produit commercial, d'une personne ou d'un bon de commande. Le 
travail d' analyse du programme ur consiste dans un premier temps a degager les diffe- 
rents types d'objets qui interviennent dans son application et leurs interactions. II lui faut 
ensuite decrire les caracteristiques communes a chaque type d'objet. 

Chaque client d'un site de commerce en ligne, par exemple, a un nom, un prenom, une 
carte bancaire, une adresse, etc., mais chaque personne est differente. Quand vous mode- 
lisez un objet, ses caracteristiques sont nominees champs, attributs, membres ou proprietes, 
selon les auteurs. De meme, un objet modelise peut realiser des actions. Une personne 
vue sous Tangle client peut effectuer les actions « commander », «demenager» ou 
« payer ». Ces actions, representees par des fonctions, sont generalement nominees 
methodes ou fonctions propres. Elles permettent d'agir sur les proprietes de l'objet. Vous 
utiliserez ici, une fois n'est pas coutume, le vocabulaire rencontre dans tous les outils de 
programmation Microsoft, qui consiste a definir un objet par ses proprietes et methodes. 
Ce vocabulaire est egalement employe dans JavaScript. 

Une fois les differents types d'objets d'une application degages, leur representation 
informatique abstraite est decrite dans une classe, aux moyens de variables, qui represen- 
ted les proprietes des objets, et de fonctions, qui representent les methodes. Ces variables 
et fonctions sont propres a la classe et ne devraient generalement etre accessibles qu'aux 
objets. C'est ce que Ton nomme 1' encapsulation des donnees. Par abus de langage, vous 
rencontrerez les termes « proprietes » et « methodes » pour une classe, alors qu'elle 
contiendra des variables et des fonctions. La classe est done le niveau d' abstraction le 
plus eleve pour la representation d'une famille d'objets. En langage courant, on pourrait 
dire que la classe est le moule general, relativement flexible, permettant la fabrication 
d'autant d'objets que desire, objets du meme type, mais pas necessairement identiques. 
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Le concept de classe 

Pour les amateurs de mathematiques, le concept de classe utilise ici se rapporte a celui de classe d'equi- 
valence pour une relation donnee. 



Un objet est un representant de la classe a partir de laquelle il est cree. On dit qu'il est une 
instance de cette classe. L'objet cree a des proprietes correspondant aux variables de la 
classe et des methodes qui correspondent aux fonctions de la classe. II se distingue des 
autres objets grace aux valeurs de ses proprietes. Si la classe represente un client humain, 
elle peut avoir quelque six milliards d'instances, toutes differentes. 

Le mode operatoire d'utilisation des classes et des objets dans PHP 5 doit respecter les 
etapes suivantes : 

1. Creez une classe de base pour l'objet. Elle doit avoir autant de variables que vous 
desirez de proprietes pour l'objet. Elle contient les fonctions qui permettent d'agir sur 
les proprietes. 

2. Creez autant d'objets que necessaire a partir du modele defini par la classe. 

3. Definissez une valeur particuliere pour une ou plusieurs des proprietes de chaque 
objet que vous venez de creer. Vous verrez que cette definition peut aussi se faire lors 
de la creation de l'objet a l'aide d'un constructeur. 

4. Utilisez les objets et manipulez-les, generalement a l'aide des methodes definies dans 
la classe. 



Classe et instance 

Les operations de base pour l'utilisation des objets sont la creation d'une classe et la defi- 
nition de ses proprietes et des methodes qui vont permettre aux objets crees a partir de la 
classe d'agir sur leurs proprietes ou de communiquer avec leur environnement. Vient 
ensuite la creation des objets proprement dits en tant qu'instances de la classe de base. 

Creation d'une classe 

Pour creer une classe avec PHP 5, procedez de la facon suivante : 

1. Declarez la classe a l'aide du mot-cle cl ass suivi du nom que vous souhaitez lui attri- 
buer. 

2. Ouvrez un bloc de code a l'aide d'une accolade ouvrante contenant l'integralite de la 
definition de la classe. 

3. Declarez les variables propres de la classe comme des variables ordinaires, avec les 
memes regies de nommage et le caractere $ obligatoire. Chaque variable doit etre 
precedee d'un modificateur d'acces precisant les possibilites d'acces a sa valeur. 
Nous reviendrons sur les choix possibles. Dans un premier temps, faites preceder 
chaque variable du mot-cle public. Les variables peuvent etre initialisees avec des 
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valeurs de n'importe quel type reconnu par PHP. En particulier, une variable peut etre 
utilisee comme un tableau cree a l'aide de la fonction array( ). L'utilisation d'autres 
fonctions PHP ou d'expressions variables est en revanche interdite pour affecter une 
valeur a une variable. Le nombre de variables declarees dans une classe n'est pas 
limite. 



Le mot-cle var 

Dans PHP 4, les variables de classe devaient etre precedees du mot-cle var. II est toujours possible de 
I'employer, mais c'est deconseille dans PHP 5. Dans PHP 4, 1'absence du mot-cle var provoque immedia- 
tement une erreur fatale et I'arret du script. 



4. Declarez les fonctions propres de la classe en suivant la meme procedure que pour les 
fonctions personnalisees a l'aide du mot-cle function, precede, comme les variables, 
d'un specificateur d'acces (par defaut le mot-cle public). Le nom des fonctions 
propres ne doit pas etre le meme que celui de la classe qui les contient, faute de quoi 
la fonction concernee aura un role particulier, comme vous le verrez ulterieurement 
dans ce chapitre. II ne doit pas non plus commencer par deux caracteres de souligne- 
ment ( ), cette notation etant reservee a certaines fonctions particulieres de PHP 5. 

5. Terminez le bloc de code de la classe par une accolade fermante. 



Attention 

Le bloc de code de la classe ne doit rien comporter d'autre que ce qui est indique ci-dessus. En particulier, 
il ne doit contenir aucune fonction ou instruction PHP situee en dehors des fonctions propres de la classe 
ou de la declaration des variables. 



L'ensemble de ces etapes est resume dans la syntaxe generale de creation d'une classe de 
l'exemple 9-1. 

PHP 5 permet de definir des constantes propres a la classe a l'aide du mot-cle const suivi 
du nom de la constante puis de sa valeur. Ces constantes peuvent avoir le meme nom que 
d'autres qui auraient ete definies en dehors d'une classe avec la fonction defineO. En 
contrepartie, elles ne sont pas accessibles a l'exterieur de la classe avec leur seul nom 
(voir plus loin la notation ::). 

Exemple 9-1 . Creation d'une classe type 

<?php 

class ma_classe 

{ 

//Definition d'une constante 

const lang="PHP 5"; <— Q 

//Definition des variables de la classe 

public $propl; <— © 

public $prop2 ="valeur" ; <— Q 

public $prop3 = arrayt "valeurO" ."valeurl") ; <— Q 

//Initialisation interdite avec une fonction PHP 
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//public $prop4= date(" d : m : Y"); Provoque une erreur fatale 
//•it********************************* 

//Definition d'une fonction de la classe 

public function ma_fonction($paraml ,$paramN) <— © 

{ 
//Corps de la fonction 

} 
} 

//fin de la classe 
?> 

Dans ce code, la variable $propl est declaree mais pas initialisee (repere ©), la variable 
$prop2 est declaree et initialisee avec une valeur de type string (repere ©), et la variable 
$prop3 est un tableau initialise en utilisant la fonction array( ) (repere ©). 

La classe contient de plus une fonction nommee ma_fonction( ) declaree publ ic, qui a la 
structure habituelle d'une fonction personnalisee et dont le corps peut utiliser des appels 
de fonctions natives de PHP. 

L'execution de ce code ne provoque aucun resultat visible, comme il se doit. 

L'exemple 9-2 presente la creation d'une classe representative d'une action boursiere 
contenant des informations generates sur chaque action. La classe etant un modele gene- 
ral, elle peut s'appliquer a toutes les actions cotees, quelle que soit la Bourse concernee. 
Vous l'enrichirez par la suite avec d'autres proprietes et d'autres methodes que celles de 
la classe d'origine. La classe nommee action contient une constante nommee PARIS defi- 
nissant l'adresse de la Bourse de Paris (repere ©), deux variables non initialisees, $nom 
(repere ©), qui contiendront l'intitule de Taction boursiere, et Scours (repere ©), qui en 
contiendra le prix, ainsi qu'une variable Ibourse initialisee a la valeur "Bourse de Paris", 
qui representera la place boursiere par defaut (repere ©). 

Chaque variable peut done avoir une valeur par defaut definie dans la classe de base, 
mais la valeur de chacune des proprietes reste entierement modifiable pour chaque objet 
cree a partir de la classe, comme vous le verrez par la suite. 

La classe action contient egalement une fonction propre definie par infoO, qui, selon 
l'heure d' execution du script et le jour de la semaine, indique si les bourses de Paris et de 
New York sont ouvertes ou non (repere ©). Cette fonction n'utilise pour l'instant aucune 
des variables de la classe. 

Exemple 9-2. Creation d'une classe action 

<?php 

class action 

{ 

//Constante 

const PARIS="Palais Brognard" ; <— 

//variables propres de la classe 

public $nom; <— © 

publ ic Scours; <— © 

public $bourse="bourse de Paris " ; <— © 
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//fonction propre de la classe 
public function info()<— Q 
{ 

echo "Informations en date du " ,date("d/m/Y H:i :s") , "<br>" ; 

$now=getdate( ) ; 

$heure= $now["hours"] ; 

$jour= $now["wday"] ; 

echo "<h3>Horaires des cotations</h3>" ; 

if(($heure>=9 && Sheure <=17)&& ($jour!=0 && $jour!=6)) 

{ echo "La Bourse de Paris est ouverte <br>"; } 

else 

{ echo "La Bourse de Paris est fermee <br>"; } 

if(($heure>=16 && $heure <=23)U ($jour!=0 && $jour!=6) ) 

{ echo "La Bourse de New York est ouverte <hr>"; } 

else 

{ echo "La Bourse de New York est fermee <hr>"; } 



?> 

Le role de la POO etant de creer des bibliotheques de classes reutilisables par n'importe 
quel script, enregistrez le code de la classe action dans un fichier separe. Pour l'utiliser, 
creez un fichier separe (l'exemple 9-3) destine a utiliser cette classe en incorporant son 
code a l'aide de la fonction requi re( ). Cette pratique est fortement recommandee. 

Exemple 9-3. Tentative d'utilisation de la classe action 

<?php 

require("objet2.php") ; <— © 

echo "Constante PARIS =" .PARIS, "<br />";<^© 

echo "Norn = ",$nom,"<br />"; <— © 

echo "Cours= ", Scours ,"<br />";<—© 

echo "Bourse^ " ,$bourse, "<br />";<—© 

//infoO; //L'appel de info( )Provoque une erreur si vous decommentez la 1 i g ne < — © 

action: :info( ) ;//fonctionne <— © 

echo "Constante PARIS =" .action: : PARIS, "<br />";<—© 

?> 

Le resultat obtenu est le suivant : 



Constante PARIS =PARIS 

Norn = 

Cours= 

Bourse^ 

Informations en date du 01/02/2009 22:20:22 

Horaires des cotations 

La Bourse de Paris est fermee 

La Bourse de New York est fermee 

Constante PARIS =Palais Brognard 
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Le code definissant la classe incorporee a l'exemple 9-3 (repere Q) est men une entite a 
part entiere dans celui du script. En effet, vous constatez en executant le script que les 
variables et les fonctions creees dans le corps de la classe ne sont pas accessibles dans le 
reste du code du script, meme si elles se situent apres la definition de la classe. La tenta- 
tive d'affichage de la constante (repere ©) et des variables de la classe (repere Q. et 
@) ne produit aucun affichage. Cela n'a rien d'exceptionnel pour les variables $nom et 
Scours, puisqu'elles sont vides, mais est plus significatif pour la variable Sbourse, car 
vous lui avez attribue une valeur lors de sa declaration. 

Pire encore, si vous tentez d'utiliser la fonction infoO de la classe action comme une 
fonction ordinaire (repere ©), vous obtenez pour toute reponse le triste message suivant : 

"Fatal error: Call to undefined function infoO in c:\wamp5\www\php5\C9objets\ 
objet3.php on line 7 " 

Cela vous indique que PHP ne reconnait pas la fonction appelee et qu'il la considere 
comme non declaree. Pour pouvoir l'utiliser en dehors de la creation d'un objet instance 
de la classe action, il vous faut faire appel a la syntaxe particuliere suivante : 

| nom_classe: :nom_fonction( ) ; 

en precisant eventuellement ses parametres, s'ils existent. Cela vous permet d'utiliser les 
fonctions propres d'une classe en dehors de tout contexte objet si elles sont declarees 
publ i c. Dans l'exemple 9-3, en ecrivant en fin de script (repere Q) le code suivant : 

action: :info( ) ; 

vous obtenez bien les informations que fournit l'execution de la fonction infoO, sans 
avoir cree le moindre objet. 

De meme, vous pouvez acceder a la constante definie dans la classe en utilisant la meme 
syntaxe en dehors de la classe (repere ©) : 

echo "Constante PARIS =" .action: :PARIS, "<br />"; 

qui affichera bien « Palais Brognard ». 

Dans la pratique professionnelle, vous avez toujours interet a separer en deux fichiers 
distincts le code de creation des classes et celui qui les utilise. Cela vous permet de reuti- 
liser la meme classe dans plusieurs scripts sans avoir a recopier le code de chacun d'eux. 



Creer un objet 



Vous venez de voir comment creer une classe, mais votre script ne dispose d'aucune 
fonctionnalite ni variable supplementaire, ce qui a toutes les chances de produire un 
resultat decevant. En reprenant l'analogie avec un moule, il vous faut maintenant utiliser 
le moule constitue par la classe pour creer des objets. 

Chaque objet cree a partir de votre classe est appele une instance de la classe. A chaque 
instance correspond un objet different. Un objet particulier est identifie par un nom de 
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variable tel que vous avez desormais l'habitude d'en ecrire et est cree a l'aide du mot-cle 
new selon le modele suivant : 

$var_objet = new nom_cl asset) 

Prenez soin que le code de definition de la classe soit dans le meme script ou soit inclus 
au debut du script a l'aide des fonctions requireO ou includeO. 

A partir de maintenant, le script possede une variable $var_objet qui a les proprietes et les 
methodes definies dans la classe de base. 

Vous pouvez le verifier en ecrivant : 

echo gettype($var_objet) 

La valeur retournee par cette fonction est bien object, vous confirmant s'il en etait besoin 
que la variable est d'un type nouveau par rapport a celles couramment utilisees jusqu'ici. 

Le nom de la classe n'a pas besoin d'etre defini par une expression explicite, comme 
vous venez de le faire, mais peut etre contenu dans une variable chaine de caracteres. 

La syntaxe suivante : 

ISmaclasse ="nom_classe" ; 
$var_objet = new $maclasse( ) ; 

cree une instance de la meme classe que le code precedent ce qui offre la possibilite de 
creer des objets dynamiquement, en fonction des saisies d'un visiteur du site par exemple. 

Pour creer des objets representant des actions boursieres conformes au modele de votre 
classe action, vous ecrivez done : 

ISactionl = new actionO; 
$action2 = new actionO; 

II est possible de verifier si un objet particulier est une instance d'une classe donnee en 
utilisant l'operateur instanceof pour creer une expression conditionnelle, selon la syntaxe 
suivante : 

if($objet instanceof nom_classe) echo "OK"; 

II vous faut maintenant personnaliser vos objets afin que chacun d'eux corresponde a une 
action boursiere particuliere. Vous agissez pour cela sur les proprietes d'un objet que 
vous venez de creer afin de le distinguer d'un autre objet issu de la meme classe. 

Pour acceder, aussi bien en lecture qu'en ecriture, aux proprietes d'un objet, PHP offre la 
syntaxe particuliere suivante, propre aux variables objets. Pour utiliser la propriete decla- 
red dans la classe par Sprop, appliquez la notation -> (caractere moins suivi du signe supe- 
rieur a) sous la forme : 

$nom_objet->prop; 
ou encore : 

$nom_objet->prop[n] ; 
si la propriete prop de l'objet est un tableau. 
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Pour appeler une methode de l'objet, appliquez la meme notation : 

$nom_objet->nom_fonction( ) ; 



Risque d'erreur 

lei, la variable est l'objet, et il n'y a jamais de signe $ devant le nom de la propriete. Par contre, les paren- 
theses et les parametres eventuels de la methode sont indispensables. 



Vous pouvez afficher sa valeur ou lui en affecter une autre. Par exemple, pour afficher la 
valeur de la propriete bourse d'un objet de type action, vous ecrivez : 

echo $actionl->bourse; 
qui affiche la valeur par defaut « Bourse de Paris » definie dans la classe. 
Pour lui affecter une nouvelle valeur, vous avez le code : 

$actionl->bourse = "New York"; 
Pour appeler la seule methode de l'objet : 

$actionl->info() 



Modifications et classe de base 

La variable $bourse de la classe action a toujours la valeur Bourse de Paris. N'importe quelle 
nouvelle instance de la classe cree un objet qui aura encore cette valeur par defaut pour la propriete 
bourse. En regie generate, les modifications operees sur un objet n'ont aucun effet sur la classe de base 
de l'objet. 



L'exemple 9-4 donne une illustration de la creation d'objets a partir de la classe action 
puis de la definition des proprietes et enfin de 1' utilisation de ces proprietes pour un affi- 
chage d' informations. 

Exemple 9-4. Creation et utilisation d'objets 

<?php 

require("objet2.php") ; <— © 

//Creation d'une action 

$actionl= new action();<— © 

//Affectation de deux proprietes 

$actionl->nom = "Mortendi " ; <— © 

$actionl->cours = 15.15; <— © 

//Utilisation des proprietes 

echo "<b>L'action $actionl->nom cotee a la $actionl->bourse vaut $actionl->cours 

*€</b><hr>"; <-© 

//Appel d'une methode 

$actionl->info( ) ; <— © 

echo "La structure de l'objet \$actionl est : <br>"; 

var_dump($actionl) ; <— © 
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echo "<h4>Descriptif de 1 'action</h4>" ; 
foreach($actionl as $prop=>$valeur) <— O 
{ 

echo "$prop = Svaleur <br />"; 
} 

if ($actionl instanceof action) echo "<hr />L'objet \$actionl est du 
**type action"; <— © 
?> 

Le code de la classe action est incorpore a l'aide de la fonction require( ) (repere ©). 
Vous creez ensuite une variable Sactionl representant un objet de type action et definis- 
sez des valeurs pour les proprietes nom et cours (reperes © et ©). Ces proprietes sont lues 
et utilisees pour creer un affichage (repere ©). L'appel de la methode de 1' objet permet 
d'obtenir des informations sur l'ouverture des bourses (repere©). La fonction var_ 
dumpO permet d'afficher, a l'usage du programmeur uniquement, le nom, le type et la 
valeur de chaque propriete (repere ©). 

Plus elegamment, vous pouvez lire l'ensemble des proprietes de l'objet $actionl a l'aide 
d'une boucle foreach (repere @). L'utilisation de l'operateur instanceof vous permet de 
verifier que l'objet est bien une instance de la classe action. 

La figure 9-1 donne le resultat du script. 
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L'acrion Mortendi cotee a la bourse de Paris vaut 15.15 € 



Informations en date du 02 02 2009 09:52:30 

Horaires des cotations 

La Bourse de Paris est ouverte 

La Bourse de Ne«' York est ferine e 



La structure de l'objet $ action 1 est : 

object(action)t;l (3) { ["nom"]=> string(8) "Mortendi" ["cours"]=> float(15.15) ["bourse"]=> string(l(5) "bourse de Paris 



'} 



Des crip tif de Taction 

nom = Mortendi 

cours = 15.15 

bourse = bourse dc Paris 



L'objet Sactionl est du type action 



Figure 9-1 

Affichage des proprietes d'un objet 
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Acces aux variables de la classe 



Comme vous venez de le voir, les variables propres de la classe ne sont pas accessibles 
directement a l'exterieur du code qui definit la classe. II est done possible d'utiliser dans 
le script des variables qui ont les memes noms sans risquer de modifier les valeurs de 
celles de la classe. De meme, 1' acces habituel aux methodes est impossible directement 
de l'exterieur de la classe. Cette particularite est nommee encapsulation et permet en 
quelque sorte de proteger la « cuisine » interne que vous avez concue pour creer une 
classe. 

De la meme facon, si vous essayez d'utiliser dans une methode une variable declaree de 
la classe, vous n'obtenez aucun resultat. 



Variables globales et superglobales 

II est possible d'utiliser dans une fonction propre une variable globale du script a I'aide du mot-cle gl obal 
(voir I'exemple 9-5). Les variables superglobales de type array, par exemple $_P0ST, sont directement 
accessibles dans le corps d'une methode. 



Pour acceder a une constante de classe dans le corps d'une fonction, utilisez la syntaxe 
particuliere suivante : 

sel f : :maconstante 

ou encore : 

nomclasse: :maconstante 

Pour acceder a cette constante a l'exterieur de la classe vous pouvez egalement utiliser 
cette derniere notation et, depuis PHP 5.3, la syntaxe suivante : 

I$classe="nomclasse" ; 
echo $cl asse: :maconstante; 

Pour qu'une methode accede aux variables declarees dans la classe, elle doit y faire appel 
a I'aide de la syntaxe suivante : 

$this->mavar 

dans laquelle la pseudo-variable $this fait reference a l'objet en cours, ce qui permet 
d'utiliser la variable $mavar dans la methode. La methode infoO de votre classe action 
peut maintenant etre enrichie et avoir comme fonctionnalite supplementaire d'afficher 
toutes les caracteristiques d'un objet action. 

Vous pouvez, par exemple, remplacer la ligne de code : 



Iec 



cho "<b>L'action $actionl->nom cotee a la bourse de $actionl->bourse 
vaut $actionl->cours _</b><hr>"; 



de I'exemple 9-4 par le code suivant, qui fera partie du corps de la fonction info( ) : 
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if(isset($this->nom) && isset(Sthis->cours) ) 
{ 

echo "<b>L'action $this->nom cotee a la bourse de {$this->bourse[0]} 

*vaut $this->cours €</b><br />";//9 
} 

La verification de l'existence des variables permet de bloquer l'affichage dans le cas ou 
aucun objet n'a ete cree, sans pour autant empecher l'appel de la fonction infoO. La 
gestion de cet affichage est transferee a une methode d'objet et ne figure plus dans le 
script qui cree l'objet. 

Cet acces aux variables de la classe est aussi valable si l'une de ces variables est un 
tableau. Pour acceder a la valeur d'un des elements du tableau, vous ecrirez, par exemple : 

$this->montab[l] 

si la variable Smontab a ete declaree dans la classe avec, par exemple, la fonction array( ) 
selon le modele : 

public Smontab - arrayC'valeurl" , "valeur2") ; 

L'exemple 9-5 permet de modifier la classe action qui definit deux constantes (reperes O 
et ©) utilisees ensuite par la methode infoO (reperes Q et ©). Vous y retrouvez les 
memes variables $nom, Scours et Sbourse, qui est un tableau (repere ©). 

La methode infoO utilise la variable globale Sclient (repere ©), qui sera definie dans le 
script creant un objet de type action (voir exemple 9-6), ainsi que le tableau superglobal 
SJiERVER pour lire le nom du serveur (repere ©). 

La lecture des elements du tableau Sbourse permet 1'affichage des horaires d'ouverture 
des bourses (repere ©). En cas de creation d'un objet et done de definition des valeurs 
de ses proprietes nom et cours, la fonction vous permet d'afficher les informations sur 
Taction creee (repere Q). 

Exemple 9-5. Utilisation des variables propres par une methode 

<?php 

class action 

{ 

//Definition d'une constante 

const PARIS="Palais Brognard" ; <— O 

const NEWYORK="Wall Street"; <-© 

//Variables propres de la classe 

public $nom ; 

public Scours; 

public Sbourse=array("Paris " , "9h00" , "18h00") ; <— © 

//fonctions propres de la classe 

function infoO 

{ 
global Sclient; <— O 
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//Utilisation de variables globales et d'un tableau superglobal 

echo "<h2> Bonjour Sclient, vous etes sur le serveur: ", 

W-$_SERVER["HTTP_H0ST"],"</h2>"; <-© 

echo "<h3>Informations en date du " ,date( "d/m/Y H:i :s" ) , "</h3>" ; 

echo "<h3>Bourse de {$this->bourse[0]} Cotations de {$this->bourse[l]} 

'•a {$this->bourse[2]} </h3>";<-0 

//Informations sur les horaires d'ouverture 

$now=getdate( ) ; 

$heure= $now["hours"] ; 

$jour= $now["wday"] ; 

echo "<hr />"; 

echo "<h3>Heures des cotations</h3>" ; 

if(($heure>=9 && $heure <=17)&& ($jour!=0 && $jour!=6)) 

( echo "La Bourse de Paris ( ", self:: PARIS," ) est ouverte 

*<br>"; } <— O 

else 

{ echo "La Bourse de Paris ( ", self:: PARIS," ) est fermee <br>"; } 

if(($heure>=16 && $heure <=23)&& ($jour!=0 && $jour!=6) ) 

{ echo "La Bourse de New York ( ", self:: NEWYORK," ) est ouverte 

*»<hr>"; } <-© 

else 

(echo "La Bourse de New York ( ", self:: NEWYORK," ) est fermee <hr>"; } 

//Affichage du cours 

if(isset($this->nom) && isset($this->cours) ) 

{ 
echo "<b>L'action $this->nom cotee a la bourse de {$this->bourse[0]} 
*vaut $this->cours €</b><br />";<— Q 

} 
} 
) 
?> 

L'exemple 9-6 utilise cette classe pour creer des objets apres l'inclusion du fichier 
objet5.php (repere 0). La variable Sclient est initialisee et sera utilisee par la methode 
info( ) (repere ©). Apres la creation d'un objet action (repere ©) puis la definition de 
ses proprietes (reperes Q et 0), l'appel de la methode i nf o( ) de l'objet (repere 0) affi- 
che l'ensemble des informations sur Taction creee et l'ouverture de la Bourse. La 
figure 9-2 illustre le resultat obtenu. 

Exemple 9-6. Creation d'un objet action 

<?php 

require( 'objet5.php' ) ; <— O 
$client="Geelsen": <— 
Smortendi = new actionO; <— © 
$mortendi->nom ="Mortendi"; <— 
$mortendi->cours="12.76"; <— 
$mortendi->info(); <— 
?> 
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Figure 9-2 

Creation et utilisation d'un objet 



Les modificateurs d'accessibilite 

Vous avez defini jusqu'a present des proprietes et des methodes qui etaient accessibles 
librement a l'aide du mot-cle public. PHP 5 introduit des niveaux d'accessibilite diffe- 
rents pour vous permettre de limiter Faeces aux proprietes et aux methodes et par la 
meme de reduire le risque de modification des proprietes. 

Accessibility des proprietes 

II existe trois options d'accessibilite, qui s'utilisent en prefixant le nom de la variable de 
la classe. Ces options sont les suivantes : 

• publ i c . Permet l'acces universel a la propriete, aussi bien dans la classe que dans tout 
le script, y compris pour les classes derivees, comme vous l'avez vu jusqu'a present. 

• protected. La propriete n'est accessible que dans la classe qui l'a creee et dans ses 
classes derivees (voir la section « Heritage » de ce chapitre). 

• pri vate . C'est l'option la plus stride : l'acces a la propriete n'est possible que dans la 
classe et nulle part ailleurs. 

Le code ci-dessous teste les differents niveaux d'accessibilite aux proprietes. La classe 
acces contient trois proprietes, munies respectivement des modificateurs public 
(repere ©). protected (repere ©) et pri vate (repere ©). La methode 1 1 reprop( ) conte- 
nue dans la classe a acces a toutes ces proprietes, et ce quel que soit le modificateur 
utilise (repere ©). La creation d'un objet (repere 0) et l'appel de cette methode affi- 
chent l'ensemble des proprietes (repere ©). L'appel de la propriete publique a partir de 
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cet objet est possible et permet d'afficher sa valeur (repere Q). Par contre, l'appel des 
proprietes protegees et privees (reperes © et Q) provoquerait une erreur fatale. Par 
contre, une boucle foreach appliquee au tableau, contenant l'ensemble des proprietes de 
la classe acces, permet d'afficher l'ensemble de ces proprietes et leur valeur (repere flj)). 

<?php 

class acces 
{ 

//Variables propres de la classe 

public $varpub ="Propriete publ ique" ; <— O 

protected $varpro="Propriete protegee" ; <— © 

private $varpriv="Propriete privee"; <— Q 

function 1 ireprop( ) <— Q 

{ 
echo "Lecture publique: $this->varpub" , "<br />"; 
echo "Lecture protegee: $this->varpro" , "<br />"; 
echo "Lecture privee: $this->varpri v" ,"<hr />"; 

} 
) 

$objet=new accesO; <— { 
$objet->l irepropt ) ; <— ( 
echo $objet->varpub; <— Q 
//echo $objet->varpriv; Erreur fatale <— © 
//echo $objet->varpro; Erreur fatale <— © 
echo "<hr />"; 

foreach(get_cl ass_vars( 'acces' ) as $prop=>$val ) <— © 
{ 

echo "Propriete ",$prop ," = ",$val,"<br />"; 
} 
?> 

Le resultat obtenu permet de visualiser les possibilites d' acces aux proprietes : 

Lecture publique: Propriete publique 
Lecture protegee: Propriete protegee 
Lecture privee: Propriete privee 

Propriete publique 

Propriete varpub = Propriete publique 
Propriete varpro = Propriete protegee 
Propriete varpriv ■ Propriete privee 

Accessibilite des methodes 

PHP 5 permet desormais de definir des niveaux d' accessibilite pour les methodes des objets. 

Vous retrouvez les memes modificateurs que pour les proprietes : 

• publ i c . La methode est utilisable par tous les objets et instances de la classe et de ses 
classes derivees. 
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• protected. La methode est utilisable dans sa classe et dans ses classes derivees, mais 
par aucun objet. 

• pri vate . La methode n'est utilisable que dans la classe qui la contient, done ni dans les 
classes derivees, ni par aucun objet. 

Tout appel d'une methode en dehors de son champ de visibilite provoque une erreur fatale. 

L'exemple 9-7 illustre l'emploi de ces modificateurs dans une classe. Celle-ci contient 
un propriete declaree private (repere ©) et trois methodes declarees, respectivement 
private (repere ©), protected (repere ©) et public (repere ©). Cette derniere appelle les 
deux autres methodes (reperes © et ©). La creation d'un objet (repere ©) et l'appel des 
differentes methodes montrent que seule la methode publique est utilisable par un objet 
(repere ©). Le fait de decommenter les deux dernieres lignes du script (reperes Q et flD) 
pour utiliser les methodes protegees et privees provoquerait une erreur fatale. Vous verrez 
a la section consacree a l'heritage des exemples d'utilisation de methodes protegees dans 
une sous-classe. 

Exemple 9-7. Accessibility des methodes 

<?php 

class accesmeth 
{ 
//Variables propres de la classe 
private $code="Mon code prive";<— 
//Methodes 
//Methode privee 

private function 1 irepri v( ) <— © 
{ 

echo "Lire privee " ,$this->code, "<br />"; 
} 

//Methode protegee 
protected function lirepro()<— © 
{ 

echo "Lire protegee " ,$this->code,"<br />"; 
} 

//Methode publique 
public function lirepub()<— Q 
{ 

echo "Lire publique : " ,$this->code, "<br />"; 

$this->lirepro(); <— © 

$this->lirepriv( ) ; <— © 

} 

} 

/ 1 ^ ********************************** 

//Appel s des methodes 
$objet=new accesmeth( ) ; <— © 
$objet->lirepub(); <— © 
//$objet->lirepro( );// Erreur fatale <— © 
//$objet->lirepriv() ; //Erreur fatale <— © 
?> 
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Le resultat obtenu en decommentant l'avant-derniere ligne est le suivant : 

Lire publique : Mon code prive 
Lire protegee Mon code prive 
Lire privee Mon code prive 

Fatal error: Call to protected method accesmeth: :1 i reprot ) from context '' in c:\wamp5\ 
www\php5\C9objets\objet8.php on line 32 



Proprietes et methodes statiques 

PHP 5 introduit la notion de propriete et de methode statique, qui permet d'acceder a ces 
elements sans qu'il soit besoin de creer une instance de la classe. Pour declarer une 
propriete ou une methode statique, vous devez faire suivre le mot-cle definissant l'acces- 
sibilite du mot-cle static. 

Comme les methodes statiques sont utilisables sans la creation d'objet, vous ne devez pas 
utiliser la pseudo-variable $this pour faire reference a une propriete de la classe dans le 
corps de la methode. Vous devez utiliser a la place une des syntaxes suivantes : 

sel f : :$propriete 
si la methode est celle de la meme classe, ou encore : 

nomclasse: :$propriete 

si la methode est celle d'une autre classe. 

Notez qu'il faut conserver le signe $ pour designer la propriete, contrairement a ce que 
vous faisiez precedemment. 

De meme, pour appeler une methode statique de la classe a partir d'une autre methode, 
vous utilisez les memes syntaxes, avec les memes conditions que ci-dessus : 

I self : :$methode( ) 
nomclasse: :$methode( ) 

Si vous creez un objet instance de la classe, la propriete declaree static n'est pas acces- 
sible a l'objet en ecrivant le code $objet->propriete. Par contre, les methodes statiques 
sont accessibles par l'objet avec la syntaxe habituelle $objet->methode( ). 

Si vous modifiez la valeur d'une propriete declaree statique a partir d'un objet, cette 
modification n'est pas prise en compte par les methodes qui utilisent cette propriete. II y 
a done un danger de confusion difficile a localiser puisque aucune erreur n'est signalee. 

L'exemple 9-8 presente ces differentes caracteristiques et leur emploi. Vous y creez une 
classe nommee info contenant une propriete statique $bourse initialisee (repere Q)- Une 
methode statique n'utilisant aucune propriete retourne simplement l'heure en cours 
(repere ©). Vous creez ensuite une methode, egalement statique, qui utilise la propriete 
$bourse et la methode precedente au moyen des notations self:: et 1 nf o : : (repere ©). 
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Pour lire la propriete $bourse a l'exterieur de la classe, ecrivez le code suivant : 

info: :$bourse (repere©). 

L'appel des methodes hors de tout contexte objet se fait de la meme facon (reperes © 
et©). 

Pour montrer le danger de l'utilisation d'une propriete statique dans un contexte objet, un 
objet de type 1 nf o (repere ©) est cree, puis une nouvelle valeur est affectee a sa propriete 
bourse (repere©). L'affichage de cette propriete montre que cette affectation est bien 
realisee (repere ©). En revanche, l'appel de la methode de l'objet qui utilise cette 
propriete permet de constater que la propriete a toujours la valeur qui a ete definie dans 
la classe (reperes ©). Le mot stati c prend alors tout son sens. 

Pour pallier cet inconvenient, il faudrait ajouter a la classe une methode speciale qui 
modifierait la propriete bourse de la maniere suivante : 

public function setbourse($val ) 
{ 
info: :$bourse=$val ; 



Exemple 9-8. Propriete et methode statiques 

<?php 

class info 
{ 

//Propriete statique 

public static $bourse="Bourse de Paris"; <— © 

//Methodes statiques 

public static function getheure( ) <— © 

{ 
$heure=date( "h : m : s"); 
return $heure; 

} 

public static function afficheinfo( ) 

{ 
$texte=info: :$bourse. " , il est " .self : :getheure( ) ; <— © 
return Stexte; 

} 
} 

echo info: :$bourse, "<br />";<—© 
echo info: :getheure( ) ,"<br />";<—© 
echo info: :afficheinfo( ) , "<hr />";<—© 
//Creation d'un objet info 
$objet=new infoO; <— © 
$objet->bourse="New York"; <— © 

echo "\$objet->bourse : " ,$objet->bourse,"<hr />";<—© 
echo "\$objet->getheure( ) : " ,$objet->getheure( ) ,"<br />";<—((!) 
echo "\$objet->afficheinfo() : " ,$objet->afficheinfo( ) , "<br />";<—© 
?> 
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Le resultat obtenu est le suivant 



Bourse de Paris 

04 : 10 : 56 

Bourse de Paris, 11 est 04 : 10 : 56 

$objet->bourse : New York 

$objet->afficheinfo( ) : Bourse de Paris, il est 04 : 10 : 56 



Constructeur et destructeur d'objet 

Dans ce qui precede, vous avez cree des objets en instanciant la classe action puis avez 
defini les proprietes des objets ainsi crees. Cette methode est un peu lourde, car elle 
implique de definir les proprietes une par une. II existe une facon plus elegante et plus 
rapide de creer des objets et de definir leurs proprietes en une seule operation. Elle 
consiste a creer un constructeur d'objet, qui n'est rien d'autre qu'une fonction speciale de 
la classe, dont les parametres sont les valeurs que vous voulez attribuer aux proprietes 
de l'objet. 

PHP 5 permet desormais de creer des constructeurs unifies avec la methode construct ( ), 

dont la syntaxe est la suivante : 

void constructtdivers $argumentl argumentN) 

Cette methode, dite « methode magique » comme toutes celles qui commencent par deux 

caracteres de soulignement ( ), porte le meme nom, quelle que soit la classe, ce qui 

permet des mises a jour sans avoir a modifier le nom du constructeur. Elle ne retourne 
aucune valeur et est utilisee generalement pour initialiser les proprietes de l'objet et 
eventuellement pour afficher un message de bonne fin. 

Elle est appelee automatiquement lors de la creation d'un objet a l'aide du mot-cle new 
suivi du nom de la classe et des parametres du constructeur, en utilisant la syntaxe 
suivante : 

$mon_objet = new nom_cl asse(paraml ,param2 ) 

Vous avez cree un objet nomme $mon_objet et initialise chacune de ses proprietes avec les 
valeurs des parametres passes a la fonction. 



Constructeur et PHP 4 

Dans PHP 4, le constructeur etait une fonction qui portait simplement le meme nom que la classe. 



De meme, vous avez la possibilite avec PHP 5 d'utiliser des destructeurs unifies a l'aide 
de la fonction destructt ), dont la syntaxe est la suivante : 

void destruct( ) 
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Elle s'utilise sans parametre car elle n'est generalement pas appelee directement et ne 
retoume aucune valeur. Elle est appelee automatiquement soit apres la destruction expli- 
cate de l'objet avec la fonction unset( ), soit apres la fin du script et la disparition de toutes 
les references a l'objet. Le corps de cette methode contient typiquement des instructions 
qui permettent de gerer proprement la destruction d'un objet, comme la fermeture expli- 
cite d'un fichier (voir le chapitre 1 1) ou d'une connexion a une base de donnees (voir le 
chapitre 15). 



Destructeur et PHP 4 

Dans PHP 4, la notion meme de destructeur n'existait pas. 
de la destruction d'un objet. 



fallait coder specialement les consequences 



Lors de la creation de sous-classes (voir la section « Heritage »), les constructeurs et 
destructeurs de la classe parente ne sont pas appeles implicitement, meme si la classe 
enfant n'a pas son propre constructeur. Pour appeler explicitement le constructeur ou 
le destructeur de la classe parente dans la classe enfant, vous devez utiliser la syntaxe 
suivante : 



parent: :_ 
parent: :_ 



_construct( ) 
_destruct( ) 



L'exemple 9-9 cree une nouvelle classe action munie de trois proprietes et d'un cons- 
tructeur, qui recoit trois parametres, le dernier ayant une valeur par defaut (repere O K 
Vous pouvez done creer un objet en ne precisant que les deux premiers. Le constructeur 
initialise les trois proprietes de l'objet (reperes Q, © et ©). Le destructeur affiche un 
message utilisant la propriete propnom et annonce la destruction de l'objet (repere 0). 

Vous creez ensuite trois objets action en utilisant la valeur par defaut du dernier para- 
metre (repere ©) ou en passant explicitement une valeur (reperes Q et ©). Vous creez 
egalement une reference a l'un de ces objets (repere Q). L'appel de la fonction var_ 
dump( ) affiche la structure de l'objet $al cotel (repere ©). La destruction explicite de cet 
objet entraine l'appel du destructeur et l'affichage d'un message (repere ©). Par contre, 
la destruction explicite de l'objet $bim (repere ©) ne provoque pas l'appel du destructeur 
car il existe encore une reference a cet objet. En consultant l'affichage realise par le 
script, vous constatez qu' apres le message de fin de script (repere ©), le destructeur est 
appele pour les objets $bim et Sbouch. 

Exemple 9-9. La classe action munie d'un constructeur et d'un destructeur 

<?php 

class action 
{ 

private Spropnom; 

private Spropcours; 

protected Spropbourse; 

function construct($nom, Scours, $bourse="Paris") <— O 
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$this->propnom=$nom; <— © 
$this->propcours=$cours ; <— © 
$this->propbourse=$bourse; <— © 

} 

function destructO 

{ 
echo "L'action $this->propnom n'existe plusKbr />";<—© 

} 
} 

//Creation d'objets 

$alcotel = new action( "Alcotel " ,10.21) ; <—© 
$bouch = new actionC'Bouch" ,9.11, "New York");<— © 
$bim - new action( " B I M " ,34.50, "New York");<— @ 
$ref=&$bim; <— © 
var_dump($alcotel ) ; <— flj) 
echo "<hr />"; 
unset($alcotel); <— © 
unset($bim); <— © 

echo "<hr /Xh4> FIN du script </h4Xhr />";<-© 
?> 



Le script afiiche le resultat suivant 



object(action)#l (3) { ["propnom:private"]=> string(7) "Alcotel" 
["propcours:private"]=> f 1 oat( 10.21) ["propbourse:protected"]=> string(5) "Paris" 



L'action Alcotel n'existe plus! 

FIN du script 

L'action Bouch n'existe plus! 
L'action BIM n'existe plus! 



Dereferencement 

Vous avez vu que l'appel d'une methode d' objet se faisait selon la syntaxe suivante : 

$varobj->methode( ) j 

Dans le cas ou la methode appliquee a un objet retourne elle-meme un objet et que celui- 
ci possede ses propres methodes, il est possible avec PHP 5 de pratiquer le dereference- 
ment. Cela permet d'enchainer les appels de methodes les uns a la suite des autres. 

Vous pouvez ecrire le code suivant : 

| $varobj->methodel( )->methode2( ) ; 

a condition que methode2() soit une methode de 1 ' objet obtenu par l'appel de methodeH). 

Dans l'exemple 9-10 vous creez une classe nommee varchar representant une chaine de 
caracteres (repere ©). Cette classe possede trois methodes. Le constructeur definit la 
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propriete chaine avec la valeur du parametre qui lui est passe (repere ©). La methode 
add( ) realise la concatenation de deux chaines (repere ©) et retourne l'objet en cours (de 
type varchar), dont la propriete chaine est modifiee (repere©). La methode getchO 
retourne la valeur de la propriete chai ne, ce qui permet son affichage (repere ©). Apres la 
creation d'un objet $texte de type varchar et 1' initialisation de sa propriete chaine 
(repere ©), l'appel de la methode getch( ) retourne cette propriete, qui est de type string 
(repere ©). II est alors impossible d'appliquer une autre methode a cette valeur. Par 
contre, si vous appelez d'abord la methode add( ), il devient possible d'enchainer avec la 
methode getchO pour allonger la chaine puis l'afficher car add() retourne un objet 
varchar (repere ©). Dans les memes conditions, vous pouvez envisager d'enchainer les 
methodes les unes aux autres et, par exemple, appliquer plusieurs fois la methode add( ) 
puis la methode getchO pour realiser un affichage (repere ©). 

Exemple 9-10. Dereferencement de methodes 

<?php 

class varchar <— © 

{ 

private Schaine; 

function construct($a) <— © 

{ 
$this->chaine= (string)$a; 

} 

function add($addch) 

{ 
$this->chaine.=$addch; <— © 
return $this; <— © 

} 

function getch( ) 

{ 
return $this->chaine; <— © 

} 
} 

//Creation d'objet 
$texte=new varcharC'Apache ");<— © 
echo $texte->getch(),"<hr />";<—© 
echo $texte->add( " PHP 5 ")->getch( ) ,"<hr />";<-© 
echo $texte->add(" MySQL " )->add(«SQLite ")->getch( ) ,"<hr />";<-© 
?> 






L'execution du script 9-1 1 affiche le resultat suivant : 



Apache 

Apache PHP 5 

Apache PHP 5 MySQL SQLite 
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Dereferencement et PHP 4 

Dans PHP 4, le dereferencement n'etait pas possible. II fallait utiliser une variable intermediaire pour 
contenir le resultat de I'appel de la premiere methode puis lui appliquer la deuxieme methode. 



Typage des parametres 

Vous savez que PHP est un langage peu type et qu'il n'est pas possible de fixer le type 
d'un parametre dans une fonction personnalisee. Cependant PHP 5 introduit une nuance 
en permettant desormais d'imposer un type au parametre d'une methode, mais unique - 
ment pour les parametres qui sont de type object ou array et pas encore pour les types de 
base de PHP, comme les types string ou integer. Pour imposer le type d'un parametre, 
vous devez faire preceder le nom de la variable par le nom de la classe dont le parametre 
doit etre une instance. 

Vous ecrivez, par exemple : 

function (action $var) 

{ 

//Corps de la fonction 

} 

Dans ce cas, le parametre $var doit etre un objet instancie a partir de la classe action et 
d'aucune autre. Si le type de la variable n'est pas conforme, une erreur fatale est generee. 



Heritage 



Vous avez considere une classe comme un moule reutilisable a l'infini pour creer des 
objets. Que se passe-t-il si le moule ne convient plus, par exemple, parce que vous voulez 
creer des objets plus perfectionnes ? Faut-il le casser et en reconstruire entierement un 
autre ? Vous pouvez aussi vouloir faire evoluer une classe en lui ajoutant de nouvelles 
fonctionnalites, que ce soit des proprietes ou des methodes, sans pour autant devoir 
modifier le code de la classe d'origine. A l'instar des langages objet plus perfectionnes, 
PHP 5 donne la possibilite de deriver de nouvelles classes a partir d'une classe donnee, 
dont elles seront des ameliorations. 



Enrichir un objet 



La definition d'une classe contient toutes les declarations des proprietes d'un objet 
instancie. Une fois l'objet cree, vous pourriez vous attendre que le nombre de proprietes 
soit fixe definitivement. Or il n'en est rien. Vous pouvez ajouter des proprietes a un objet 
en cours de script sans avoir a modifier la classe. II vous suffit pour cela d' utiliser la nota- 
tion d' affectation d'une propriete sous la forme suivante : 

$objet->propriete = "valeur" 
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L'exemple 9-11 reprend l'essentiel de la definition de la classe action de l'exemple 9-10 
en definissant trois proprietes publ ic et un constructeur (repere ©). 

Une fois cree, l'objet $bim possede trois proprietes, que vous pouvez lire ou modifier 
(repere ©). La fonction var_dump( ) permet de visualiser ces proprietes (repere ©). 

L'affectation d'une nouvelle propriete (repere©) est realisee avec la syntaxe $bim-> 
date="2001", comme s'il existait une propriete date. Un nouvel appel de var_dump() 
montre la nouvelle structure de l'objet $bim, qui contient bien maintenant quatre proprie- 
tes (repere ©). Cette propriete est accessible en lecture et en ecriture en tout point du 
script, car elle est consideree comme ayant le niveau d'acces publ ic (repere ©). 

Exemple 9-1 1 . Ajout dynamique d'une propriete 

<?php 

cl ass action <— O 

{ 

public Spropnom; 

public Spropcours; 

public Spropbourse; 

function cons truct($nom, Scours, $bourse) 

{ 
$this->propnom=$nom; 
$this->propcours=$cours; 
$this->propbourse=$bourse; 

} 
} 

$bim = new actionC'BIM" ,9.45, "New York");^© 
var_dump($bim) ; <— © 
$bim->date="2001"; ^© 
echo "<hr />"; 
var_dump($bim) ; <— © 
echo "<hr />"; 

echo "Propriete date : " ,$bim->date; <— © 
?> 

L'affichage realise par ce script est le suivant : 



object(action)#l (3) { ["propnom"]=> stringO) " B I M " ["propcours"]=> float(9.45) 

["propbourse"]=> string(8) "New York" ) 

object(action)#l (4) { ["propnom"]=> stringO) " B I M " ["propcours"]=> float(9.45) 

["propbourse"]=> string(8) "New York" ["date"]=> string(4) "2001" } 



Propriete date : 2001 



II montre bien que l'objet possede une propriete supplementaire par rapport a celles defi- 
nies dans la classe dont il est une instance, mais la classe reste telle qu'elle a ete definie, 
bien sur. 
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Creation d'une c/asse derivee 



Le mecanisme de 1' heritage est fondamental en POO. II vous permet, en fonction des 
besoins, de faire evoluer une classe sans la modifier en creant une classe derivee — on dit 
aussi une classe enfant, ou une sous-classe — a partir d'une classe de base, ou classe 
parente. La classe derivee herite des caracteristiques (proprietes et methodes) de la classe 
parente, et vous lui ajoutez des fonctionnalites supplementaires. Vous pouvez ainsi creer 
toute une hierarchie de classes en specialisant chaque classe selon vos besoins. Contrai- 
rement a d'autres langages, PHP 5 n'autorise que 1' heritage simple, une classe ne pouvant 
heriter que d'une seule classe parente. 

Pour creer une classe enfant, faites suivre le nom de la nouvelle classe du mot-cle extends 
puis du nom de la classe parente, selon la forme suivante : 

class classenfant extends classparent 

{ 

//Proprietes et methodes nouvelles 

} 

Dans le corps de la classe enfant, il est possible de redefinir les proprietes et les methodes 
de la classe parente, sauf si elles sont declarees private ou final (voir plus loin). II est 
encore possible d'acceder aux proprietes et aux methodes redefinies de la classe parente 
en les faisant preceder du mot-cle parent::. Si elles ne sont pas redefinies, la classe 
enfant possede les memes proprietes et les memes methodes que la classe parente. 



Cas particulier des constructeurs et destructeurs 

Meme si la classe parente possede un constructeur et un destructeur unifie crees avec les methodes 

construct ) et destructt ), la classe enfant ne possede pas ces methodes par defaut. II taut 

recreer un constructeur et un destructeur propres a la classe enfant. Pour utiliser ceux de la classe 

parente, il faut les appeler explicitement avec la syntaxe parent: : construct ) ou parent: : 

destructt ). 



L'exemple 9-12 illustre le mecanisme de l'heritage en creant une classe valeur represen- 
tant une valeur mobiliere plus large qu'une action (repere ©). A elle seule, cette classe 
pourrait permettre la creation d'objets. Elle contient en effet deux proprietes (reperes © 
et ©) et deux methodes, un constructeur et une methode d'affichage (reperes © et ©). A 
partir de cette classe de base, vous creez une classe derivee action (repere©), qui 
possede une propriete supplementaire (repere ©). Elle redefinit un constructeur en utili- 
sant le constructeur parent (repere @) et enrichit la fonction d'affichage (repere 0). Une 
deuxieme classe derivee de la classe valeur represente un titre d'emprunt (repere©). 
Elle herite egalement des proprietes de la classe parente et y ajoute deux proprietes 
(reperes © et ©). Elle cree egalement un constructeur adapte recevant quatre parametres 
(repere ©). Celui-ci utilise egalement le constructeur parent (repere ©). Enfin, elle 
redefinit la fonction d'affichage pour 1' adapter a la nature de l'emprunt (repere ©). La 
creation des objets $actionl, $action2 et $emprunt montre que chacun d'eux a un construc- 
teur et une methode i nf o( ) (reperes © © et ©). 
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Exemple 9-12. Creation de classes enfants 

<?php 

//Classe valeur 

cl ass valeur <— O 



( 
protected $nom; <— © 
protected $prix; <— © 

function construct($nom,$prix) <— © 

{ 
$this->nom=$nom; 
$this->prix=$prix; 
} 

protected function getinfo()<— © 
{ 
$info="<h4>Le prix de $this->nom est de $this->prix </h4>"; 
return $info; 
} 
} 

//Classe action 

class action extends valeur <— © 
{ 
public $bourse; <— © 

function construct ($nom,$prix,$bourse=" Paris") 

{ 

parent: : construct($nom,$prix) ; <— © 

$this->bourse=$bourse; 
} 

public function getinfo()<— © 
{ 
$info="<h3>Action $this->nom cotee a la bourse de $this->bourse </h3>" 
$info.=parent: :getinfoC ) ; 
return Sinfo; 
} 
} 

//Classe emprunt 

class emprunt extends valeur <—© 
{ 
private $taux; <— © 
private $ f i n ; <— © 

function construct($nom,$prix,$taux,$fin) <— © 

{ 

parent: : construct($nom,$prix) ; <— © 

$this->taux=$taux; 
$this->fin=mktime(24,0,0,12,31,$fin); 



public function getinfo()<— © 
{ 

$reste=round( ($this->fin - timeO ) /86400); 

$info="<h3>Emprunt $this->nom au taux de $this->taux % </h3>" 
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$info.=parent: :getinfo( ) ; <— © 

$info.="<h4>Echeance : dans Sreste jours</h4>"; 

return $info; 
} 
} 

//Creation d'objets 

$actionl = new action( "Alcotel " ,9.76) ; <— © 
echo $actionl->getinfo( ) ; 

$action2 = new action( "BMI" ,23.75, "New York");<— © 
echo $action2->getinfo( ) ; 

$emprunt = new empruntC'EdF" ,1000,5.5,2012) ; <— © 
echo $emprunt->getinfo( ) ; 
?> 

L'affichage obtenu est presente a la figure 9-3. 
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Figure 9-3 

Creation de classes enfants 

Late Static Binding 

Le mecanisme du Late Static Binding (que Ton peut traduire par liaison statique tardive) 
a ete introduit dans la version PHP 5.3 et permet de resoudre les problemes qui surve- 
naient quand une methode statique etait redefinie dans une classe derivee et qu'une autre 
methode statique heritee de la classe parent y faisait appel. En effet, dans ce cas, e'est la 
methode statique de la classe parent qui etait utilisee, 1' appel se faisant jusqu'a present 
avec la syntaxe : 



| self : :methode( ) 
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Pour pallier cet inconvenient, la version PHP 5.3 introduit un nouvel usage du mot-cle 
static. En utilisant la syntaxe : 

static: :methode( ) 

c'est bien la methode redefinie de la classe enfant qui est appelee. 

Le code suivant illustre cette nouveaute: 

<?php 

class pere <— 



( 



static public function info($nom) <— 
{ 

static: :affiche($nom) ; <— © 
} 

static public function affiche($nom) <— 
{ 

echo "<h3>Je suis le pere $nom </h3>"; 
} 



) 



class fils extends pere 
{ 

static public function affiche($nom) <— 

{ 
echo "<h3>Je suis le fils $nom </h3>"; 



) 



f1ls::1nfo('Matth1eu')j <— 
?> 



La classe pere (repere 0) definit deux methodes statiques infoO et afficheO (reperes © 
et 0), la methode i nf o ( ) appelant la methode af f i che ( ) (repere ©). La classe fils, deri- 
vee de la precedente, redefinit la methode statique afficheO (repere 0) et herite de la 
methode i nf o ( ) . L'appel de la methode statique i nf o ( ) de la classe fils (repere 0) affiche 
bien, comme nous le desirons : 

Je suis le fils Matthieu 

et non pas, comme c'etait le cas avant la version 5.3 : 

Je suis le pere Matthieu 



si Ton utilisait self : :affiche($nom) au lieu de static: :affiche($nom). 
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Les classes abstraites 



PHP 5 fournit un degre supplementaire d' abstraction des classes en permettant la creation 
de classes et de methodes abstraites. Une classe abstraite ne permet pas l'instanciation 
d'objets mais sert uniquement de classe de base pour la creation de classes derivees. 
Elle definit en quelque sorte un cadre minimal auquel doivent se conformer les classes 
derivees. 

Une classe abstraite peut contenir des methodes declarees public ou protected, qu'elles 
soient elles-memes abstraites ou non. Une methode abstraite ne doit contenir que 
sa signature, sans aucune implementation. Chaque classe derivee est chargee de creer sa 
propre implementation de la methode. Une classe contenant au moins une methode 
abstraite doit obligatoirement etre declaree abstraite, sinon elle permettrait de creer des 
objets qui auraient une methode non fonctionnelle. 

Pour creer une classe abstraite, faites preceder le mot-cle class du mot-cle abstract, 
comme ceci : 

abstract class nomclasse 

{ 

//Definition de la classe 

} 

Pour creer une methode abstraite, faites egalement preceder le modificateur d'acces du 
mot-cle abstract, selon le modele suivant : 

abstract public function nomfonctiont ) ; 

Dans la classe qui derive d'une classe abstraite, vous devez definir les modificateurs 
d'accessibilite des methodes avec une visibilite egale ou plus large que celle de la methode 
abstraite. Une classe abstraite definie, par exemple, protected, est implementee dans les 
classes derivees comme protected ou publ ic. 

L'exemple 9-13 reprend la creation des classes enfants action et emprunt de l'exemple 9- 
12. II permet de realiser la meme operation mais a partir d'une classe abstraite nommee 
valeur (repere O). A la difference de l'exemple precedent, il n'est pas possible de creer 
des objets a partir de la classe valeur. Vous ne pouvez le faire qu'a partir de ses classes 
derivees. Cette classe valeur contient deux proprietes et deux methodes abstraites (repe- 
res et ©). Chacune des classes derivees (reperes © et Q) doit done creer sa propre 
implementation complete de ces methodes (reperes 0, @, © et 0). II n'est plus ques- 
tion ici d'utiliser une methode parente, comme dans l'exemple 9-13. Le code s'en trouve 
alourdi, ce qui doit faire reflechir avant d'utiliser des classes abstraites. 

Exemple 9-13. Derivation de classe abstraite 

<?php 

//Classe abstraite valeur 

abstract class valeur <— © 

{ 

protected $nom; 

protected $prix; 
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abstract protected function constructO ; <— © 

abstract protected function getinfot ) ; <— Q 
} 

//Classe action 

class action extends valeur<— Q 
{ 
private $bourse; 

function construct($nom,$prix,$bourse="Paris" ) <— Q 

{ 
$this->nom=$nom; 
$this->prix=$prix; 
$this->bourse=$bourse; 



public function getinfo()<— Q 



$info="Action $this->nom cotee a la bourse de $this->bourse <br />"; 
$info.="Le prix de $this->nom est de $this->prix" ; 
return $info; 



) 



} 

//Classe emprunt 

class emprunt extends valeur<— Q 
{ 
private $taux; 
private $f in; 

function construct($nom,$prix,$taux,$fin) <— © 

{ 
$this->nom=$nom; 
$this->prix=$prix; 
$this->taux=$taux; 
$this->f in=mktime(24,0,0, 12,31, $f in); 



public function getinfo()<— Q 



$reste=round(($this->fin-time())/86400); 

$info="Emprunt $this->nom au taux de de $this->taux % <br />"; 

$info.="Echeance : fin $f in (dans $reste jours)"; 

return $info; 
} 
} 

//Creation d'objets 

$actionl = new actionC'Alcotel " ,9.76) ; 
echo "<h4>", $actionl->getinfo( ) , " </h4>"; 
$action2 = new actionC'BMI" ,23.75,"New York"); 
echo "<h4>", $action2->getinfo( ) ,"</h4>"; 
$emprunt = new empruntC'EdF" ,1000,5.5,2012) ; 
echo "<h4>", $emprunt->getinfo( ) , "</h4>" ; 
?> 

Le resultat obtenu est identique a celui de l'exemple 9-13, presents a la figure 9-3. 



La programmation objet 

Chapitre 9 



Les interfaces 



La conception orientee objet s'accompagne d'une decomposition de l'application en 
modules elementaires. L' introduction des interfaces dans PHP 5 permet cette decompo- 
sition en briques de base qu'une classe utilise comme modele. 

La notion d'interface est encore plus restrictive que celle de classe abstraite. Une inter- 
face ne doit contenir aucune declaration de proprietes. C'est la classe qui l'implemente 
qui doit se charger de ces declarations. Une interface ne contient aucune implementation 
de methode, a la difference d'une classe abstraite, qui peut contenir des methodes entie- 
rement definies. Les methodes qu'elle contient ne peuvent etre declarees qu'avec le 
modificateur publ 1 c ou aucun modificateur, ce qui est equivalent. L'interface ne fait que 
definir une structure a laquelle la classe qui l'implemente doit se conformer. PHP 5 
n'admet pas l'heritage multiple, mais une classe peut implementer plusieurs interfaces. 

La structure d'une interface doit respecter la forme suivante : 

interface nom_interface 
{ 

public function fonctionl($var) ; 

public function fonction2($var) ; 
} 

Pour implementer une interface dans une classe, il faut faire suivre le nom de la classe du 
mot-cle implements a la place de extends puis des noms des interfaces separes par des 
virgules. 

Vous avez done la structure suivante : 

class nom_classe implements interface]. ,interface2 

{ 

//Implementation des methodes des interfaces 

} 

Les interfaces definissant un cadre a respecter strictement, la classe qui les implemente 
doit obligatoirement definir toutes les methodes des toutes les interfaces. 

L'exemple 9-14 cree une interface nommee abscisse (repere ©) qui declare une methode 
setxO, dont le role est d'initialiser une abscisse (repere©). II cree egalement une 
interface nommee ordonnee (repere©) declarant une methode setyO, dont le role est 
similaire pour 1' ordonnee d'un point (repere ©). 

Ces interfaces sont implementees par deux classes differentes. La classe pointaxe repre- 
sente un point sur un axe, n'ayant done qu'une seule coordonnee. Elle implemente 
l'interface abscisse (repere©) et definit la methode setxO (repere©). La classe 
pointplan represente un point du plan, avec deux coordonnees. Elle implemente done les 
deux interfaces abscisse et ordonnee (repere ©) et definit les methodes setx( ) (repere ©) 
et sety ( ) (repere ©), comme l'imposent les interfaces. 

L' implementation des interfaces dans une classe impose certes la definition de leurs 
methodes mais n'empeche pas d'enrichir la classe avec d'autres methodes. La classe 
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pointplan possede une methode supplementaire moduleO, qui retourne la distance du 
point M(x,y) a l'origine du repere (repere ©). Elle pourrait, par exemple, s'enrichir 
d'une methode retournant Tangle (Ox,OM) et permettre ainsi la gestion des nombres 
complexes. 

Exemple 9-14. Creation d'interface et implementation 

<?php 

interface abscisse<— O 



public function setx($x); <— © 



{ 

} 

// 

interface ordonnee <— © 

{ 

public function sety($y); <— © 
} 

//Classe 

class pointaxe implements abscisse<— © 
{ 

public $x; 

public function setx($x) <— © 



$this->x=$x; 



} 

// 



class pointplan implements abscisse, ordonnee <—© 



( 



public $x; 
public $y; 

public function setx($x) <— © 

$this->x=$x; 

public function sety($y) <— © 

$this->y=$y; 

public function module()<— © 

return sqrt($this->x*$this->x+$this->y*$this->y) ; 



} 

//Creation d'objets 

$pointl = new pointaxeO; 

$pointl->setx(21); 

var_dump($pointl) ; 

echo "<hr />"; 

// 
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$point2 = new pointplanO; 

$point2->setx(7) ; 

$point2->sety(-5); 

var_dump($point2) ; 

echo "<hr />"; 

echo "Coordonnees du point M ( $point2->x , 

echo "Distance OM = ", $point2->module() ; 

?> 

Le resultat affiche est le suivant : 



3int2->y ) <br />" 



object(pointaxe)#l (1) { ["x"]=> int(21) } 

object(pointplan)#2 (2) { ["x"]=> int(7) ["y"]=> int(-5) } 

Coordonnees du point M ( 7 , -5 ) 
Distance OM = 8.60232526704 



Methode et c/asse finales 

La creation de sous-classes et la redefinition des methodes sont les elements essentiels de 
la POO. II peut cependant etre necessaire d'empecher toute modification d'une methode 
ou d'une classe, en particulier dans un projet oil Ton travaille en equipe. 

Pour interdire la redefinition d'une methode d'une classe parente dans ses classes deri- 
vees, faits preceder le mot-cle function du mot-cle final. 

Si vous definissez la classe suivante : 

class triangle 
{ 

private $x ; 

private $y ; 

private $z ; 

function construct($x,$y ,$z) 



$this->x=$x 
$this->y=$y 
$this->z=$z 



final function trianglerect( ) 
{ 

if(($this->x*$this->x + $this->y*$this->y) ==($this->z*$this->z) ) 

^return "Le triangle est rectangle"; 

else echo "Triangle non rectangle"; 



) 
} 

dans laquelle la fonction trianglerect( ) est declaree final, il devient impossible de creer 
une classe derivee qui contienne une methode portant le meme nom. 
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Le code suivant : 

class triangleiso extends triangle 
{ 

function trianglerectt ) 

{ 

//Instructions 

} 
} 

provoque l'apparition d'une erreur fatale et du message : 



Fatal error: Cannot override final method triangle: :trianglerect( ) 

De meme, pour interdire Pheritage d'une classe parente dans une classe enfant, faites 
preceder le mot-cle class du mot-cle final. 

Si vous definissez la classe suivante : 

final class triangle 



{ 



//Instructions 
} 

et si vous tentez de la deriver en creant la classe enfant suivante : 

class triangleiso extends triangle 
{ 

//Instructions 
} 

vous creez egalement une erreur fatale accompagnee du message : 

Fatal error: Class triangleiso may not inherit from final class (triangle) 



Clonage d'objet 

La notion de clonage d'objet est une des nouveautes introduites dans PHP 5. Elle permet 
d'effectuer une copie exacte d'un objet mais en lui affectant une zone de memoire diffe- 
rente de celle de l'objet original. Contrairement a la creation d'une simple copie a l'aide 
de l'operateur = ou d'une reference sur un objet avec l'operateur &, les modifications 
operees sur l'objet clone ne sont pas repercutees sur P original. 

Pour doner un objet, utilisez le mot-cle cl one selon la syntaxe suivante : 

Sobjetclone = clone $objet ; 

L'objet clone a exactement les memes proprietes et les memes methodes que P original. 
Apres le clonage, les modifications operees sur la variable $objet n'ont aucun effet sur le 
clone, et reciproquement. 
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Si, lors du clonage, vous voulez modifier des proprietes du clone par la meme occasion, 

vous utilisez la methode predefinie cloneO propre a tous les objets PHP 5. Elle peut 

contenir toutes sortes d' instructions agissant sur les proprietes du clone. Sa presence 
dans la classe est facultative. Si elle existe, elle est appelee automatiquement lors de la 
creation d'un clone avec le mot-cle cl one. Comme le constructeur, elle ne peut etre appe- 
lee directement. 

L'exemple 9-15 fait apparaitre les differences entre une simple copie, une reference et un 
clonage. Vous y definissez une classe action simplifiee (repere Q) ayant une seule 
propriete et un constructeur (repere @), un destructeur, qui affiche un message apres 

la destruction de l'objet (repere©), et une methode cloneO chargee de modifier la 

propriete nom (repere 0). Vous l'utilisez ici uniquement pour distinguer le clone de 
P original. 

Pour verifier les differences de comportement des copies et des clones, vous creez un 
objet $alcotel (repere 0), son clone dans la variable $clone (repere 0) et une copie et 
une reference de $alcotel, respectivement dans $bim (repere Q) et $ref (repere ©). La 
modification de la propriete nom de l'objet $bim (repere Q) est repercutee dans les objets 
Sal cotel et $ref, comme le prouve l'affichage de leur propriete nom (reperes flj) et ©). 

L'affichage simple des variables $al cotel, Sbimet $ref fournitle meme resultat (Object id 
#1), qui montre que ces trois objets font bien reference au meme espace memoire 
(repere @). En revanche, le meme affichage pour l'objet $cl one fournit un resultat diffe- 
rent : Object id #2 (repere ©). 

La destruction du clone (repere ©) entraine immediatement l'appel du destructeur, 
alors que la destruction successive des autres objets (reperes ©, © et ©) montre que le 
destructeur n'est appele qu'apres la destruction de la derniere reference a l'objet 

$alcotel. 

Exemple 9-15. Copie et clonage 

<?php 

class action <— O 

{ 

public $nom; 

function construct($nom) <— © 

{ 
$this->nom=$nom;//2 

} 

function destruct( ) <— © 

{ 
echo "faction $this->nom n'existe plusKbr />";//5 

} 

function cloneO <— O 

{ 
$this->nom="Clone de " .$this->nom; 

} 
) 
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//Creation d'objets 

$alcotel = new actionC'Alcotel ",10.21) ; <— © 

$clone= clone $alcotel ; <— © 

$bim=$alcotel ; <— © 

$ref=&$bim; <— © 

//Modification d'une propriete 

$bim->nom="BIM"; <^© 

echo $ref->nom ,"<hr />";<—© 

echo $alcotel->nom ,"<hr />";<—© 

echo "alcotel = Salcotel : bim - $bim : ref = $ref : <hr />";■ 

echo "clone = Sclone <hr />";<—© 

//Suppression des objets 

unset($clone) ; <— © 

unset($alcotel ) ; <— © 

unset($bim); <— © 

unset($ref); <^© 

?> 

Le resultat affiche par ce script est le suivant : 

BIM 

BIM 

alcotel = Object id #1 : bim = Object id #1 : ref = Object id #1 : 

clone = Object id #2 



© 



faction Clone de Alcotel n'existe plus! 
L'action BIM n'existe plus! 



Le clonage d'objet peut done etre utile pour preserver l'etat d'un objet hors de toute 
modification intempestive. 



Les namespaces 

Comme nous l'avons deja preconise a propos des fonctions, quand un projet pend de 
l'importance, et encore davantage quand il est realise en equipe, il y a tout interet a 
modulariser le code, chaque developpeur travaillant sur un module donne. Introduits 
dans PHP 5.3 les namespaces (espaces de noms), qui sont les equivalents, par exemple, 
des packages en Java, facilitent cette modularisation. lis nous permettent d'eviter egale- 
ment les conflits de noms de classe, proprietes, methodes et fonctions. En effet, un de 
ces elements peut avoir le meme nom qu'un autre sans creer de conflit au moment 
de son appel, du moment que ces deux elements sont definis dans des namespaces 
differents. 
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Syntaxe PHP 5.3 et PHP 6 

Au moment ou ces lignes sont ecrites, la version definitive de PHP 5.3 n'est toujours pas sortie et les 
nouveautes qui sont annoncees ne sont pas necessairement figees. En particulier le separateur utilise 
dans le nom des namespaces pourrait soit etre les caracteres : : , comme dans les exemples qui suivent 
bases et testes sur la version PHP 6, soit le caractere anti-slash \, ce que confirment les tests effectues 
avec la version alpha 3 de PHP 5.3. Si ce choix se confirme, il vous suffirait de remplacer les caracteres : : 
dans les exemples suivants par le caractere \. 



Creation et utilisation 

En pratique les namespaces sont des fichiers PHP ne definissant chacun qu'un seul 
espace de noms et qui peuvent contenir des definitions de classes, de constantes ou de 
fonctions. La premiere ligne du fichier doit contenir le mot-cle namespace suivi du nom 
choisi et se terminer par le traditionnel caractere ; comme n'importe qu'elle instruction. 
Tout ce qui suit cette ligne appartient au namespace nomme et a lui seul. Une mise en 
oeuvre simple de namespace est presentee dans l'exemple 9-16. 

*"* Exemple 9-16. Exemple de namespace 

<?php 

namespace MonEspace: :Test; <— O 

const MYNAME = "Espace : MonEspace: :Test" ; <— © 

function get( ) <— © 
{ 
echo "Je suis la fonction get() de 1 'espace ". NAMESPACE, 



. "<hr />"; 



) 

class Personne <— © 
{ 

public $nom="JRE" ; <— © 

public function construct($val ) <— © 

{ 
$this->nom=$val ; 

} 

public function get()<— © 

{ 
return $this->nom; 

} 
) 
?> 



Nous y creons un espace de noms nomme MonEspace: :Test compose d'un nom principal, 
MonEspace, et d'un nom secondaire, Test (repere ©). Vous pouvez done ensuite creer un 
autre espace de noms, dans un autre fichier .php (car il est impossible actuellement 
d'utiliser deux fois le mot-cle namespace dans le meme fichier, ce qui est comprehensible 
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dans une optique de modularisation organisee) en le nommant par exemple MonEspace: : Base 
pour creer des fonctions ou des classes de gestion des bases de donnees. Ce type de nota- 
tion peut done vous permettre de creer un nombre important de modules ayant chacun 
une application particuliere. Cet espace contient successivement la definition d'une cons- 
tante, de la meme maniere que dans une classe avec le mot-cle const (repere @), puis la 
declaration d'une fonction (repere ©) et enfin celle d'une classe (repere ©) contenant 
une propriete (repere ©), un constructeur (repere ©) et une methode (repere ©). 

Tel quel notre espace de noms, a l'image d'une classe, ne sert a rien. Ecrire, par exemple, 
dans un script, apres avoir inclus le fichier du namespace, la ligne suivante : 

echo MYNAME; 

pour lire la constante, ou encore appeler la fonction get( ) produit des erreurs. 

L'exemple 9-17 illustre l'utilisation du namespace de l'exemple 9-16. Vous commencez 
done par inclure le fichier objetl6.php (repere ©) puis vous pouvez ensuite utiliser la 
constante MYNAME qui y a ete definie en la prefixant avec le nom du namespace 
MonEspace: :Test: :MYNAME (repere ©). De meme vous pouvez appeler la fonction get() 
en la prefixant egalement (repere ©). II est possible de limiter le prefixe a la derniere 
partie du nom du namespace (ici Test) a condition d'utiliser auparavant le mot-cle use 
suivi du nom complet de 1' espace de noms (repere ©). La constante et la fonction get( ) 
sont alors accessibles avec les formes courtes Test::MYNAME (repere©) et Test::get() 
(repere ©). Pour creer un objet Personne, vous avez le choix entre la forme longue 
MonEspace: :Test: :Personne() du constructeur (repere©) ou la forme courte PersonneO 
(repere ©) habituelle, a condition d'utiliser avant le mot-cle use suivi du nom complet du 
namespace et du nom de la classe (repere ©). Si 1' espace de noms contient plusieurs 
classes, vous pouvez proceder de la meme facon pour chacune d'elles. II est alors beau- 
coup plus pratique de creer des objets avec une syntaxe simplified. Les methodes de ces 
objets sont appelees comme d'habitude a partir des variables objets (repere ©). 



Exemple 9-17. Utilisation d'un namespace 

<?php 

require 'objetl6.php' ; <— © 

//Constante 

echo"Une constante : ", MonEspace: :Test: :MYNAME ,"<hr />";<—© 

echo "Appel de la fonction get() de 1 'espace MonEspace: :Test : 

echo MonEspace: :Test: :get( ); <—© 

use MonEspace: :Test; <— © 

echo"Une constante : ", Test: :MYNAME, "<hr />";<—© 

echo "Appel de la fonction get() de 1 'espace MonEspace: :Test : 

echo Test::get(); <— © 



//Objet 1 

$moi = new MonEspace: :Test: :Personne( "Moi ") ; 

//Objet 2 



^O 
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use MonEspace: :Test: rPersonne ; <— © 

$toi - new PersonneC'Elle" ) ; <— © 

//********Methode et fonction du namespace 

echo "Appel de la methode get() des objets Personne : <br />"; 

echo $toi->get(), " et " ,$moi->get( ) ; <— © 

?> 

Nous allons maintenant envisager la creation et l'utilisation de differents espaces de 
noms pour modulariser le gestion dans le cadre de nos exemples boursiers. Le premier 
namespace cree dans l'exemple 9-18 permet la gestion des actions ; il contient la defini- 
tion d'une classe Valeur qui possede deux proprietes (reperes O et ©), un constructeur 
(repere ©) et deux methodes (reperes © et ©). 

Exemple 9-18. Le namespace des actions 

<?php 

namespace Bourse: :Action; 

class Valeur 

{ 

public $nom; <— © 

publ ic Scours; <— © 

public function construct($nom,$valeur) <— © 

{ 

$this->nom=$nom; 

$this->cours=$valeur; 



public function info()<— © 
{ 

echo dateCd / m / Y : '); 

echo "L'action $this->nom vaut $this->cours €<br />"; 
} 

public function changeCours($val ) <— © 
{ 

$this->cours=$val ; 
} 



) 



?> 



Le second, cree dans l'exemple 9-19, permet la gestion des obligations (emprunts) ; il 
contient les definitions d'une fonction dateO de meme nom qu'une fonction native de 
PHP (repere ©). d'une classe Val eur qui possede trois proprietes (reperes ©, © et ©), 
un constructeur (repere ©) et deux methodes (reperes © et ©). Les proprietes et 
methodes ont volontairement les memes noms, ce qui pourrait se produire si les deux 
namespaces etaient crees par des developpeurs differents dans le cadre d'un travail en 
equipe. Nous allons voir que l'avantage des namespaces est de pouvoir en employer 
plusieurs sans qu'il y ait de conflits de noms. 
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Namespace global 

Si un namespace contient une fonction de meme nom qu'une autre du script en cours ou qu'une fonction 
native PHP, cette derniere doit etre appelee dans la definition du namespace en precisant qu'elle fait partie 
du namespace global en la faisant preceder par la notation double deux points ( : : ). Dans I'exemple 9-1 9, 
le namespace contient une fonction dateO qui lui est propre. Pour utiliser la fonction native PHP date( ), 
nous devons ecrire : :date( ) afin de preciser qu'il s'agit de celle du namespace global (repere Q de 
I'exemple 9-19). 



Exemple 9-19. Le namespace des obligations 

<?php 

namespace Bourse: : Obi igation; 

function date()<— O 



echo " Fonction date" ; 

} 

class Valeur 

{ 

public $nom; <— © 

public Scours; <— Q 

public $taux; <— Q 

public function construct($nom,$valeur,$taux) <— Q 

{ 

$this->nom=$nom; 

$t hi s->cours=$ valeur; 

$this->taux=$taux; 



public function info()<— Q 
{ 

echo : :date('d / m / Y : '); <— Q 

echo "L'obl igation $this->nom a $this->taux % vaut $this->cours € 

*<br />"; 



public function changeCours($val ) <— Q 

{ 
$this->cours=$val ; 

} 
} 
?> 

L' exemple 9-20 utilise les classes de ces deux namespaces Bourse-Action et Bourse:: 
Obligation. Apres l'inclusion des deuxfichiers objetlS.php et objetl9.php qui les definis- 
sent (reperes O et ©)> nous declarons l'utilisation de l'espace Bourse-Action avec le 
mot-cle use (repere ©). Ceci permet la creation d'un objet representant une action avec 
le mot-cle new (repere 0) en precisant le nom du namespace necessaire pour distinguer 
l'objet cree, car il existe une autre classe valeur dans le second namespace inclus. II n'y a 
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ensuite aucun probleme a utiliser les methodes info( ) et changeCours( ) de l'objet (repe- 
res ©, © et ©) qui, au vu des resultats affiches, sont bien celles de la classe Valeur du 
namespace Acti on. Avec la meme syntaxe, nous utilisons le namespace Bourse : : Obi i gati on 
(repere ©) et nous creons un objet Valeur representant cette fois ci une obligation 
(repere 0), puis nous appelons ses methodes (reperes ©, et 0). 

Exemple 9-20 Utilisation de plusieurs namespaces 



^0 



<?php 

require 'objetl8.php' 

require 'objetl9.php' 

//Objet Action 

use Bourse: :Action ; <— © 

$action = new Action: :Valeur( "Dexia" ,4.56) ; <— © 

$action->info( ) ; <— © 

$action->changeCours(4.72) ; <— © 

$action->info( ); <— © 

//Objet Obligation 

use Bourse: :0bl igation; <—© 

$oblig = new Obi igation: :Valeur("EdF" ,55,3.8) ; <— © 

$oblig->info(); <-© 

$oblig->changeCours(56); <— 

$oblig->info(); <-© 

?> 

Les resultats affiches sont les suivants : 



02 / 02 / 2009 

02 / 02 / 2009 

02 / 02 / 2009 

02 / 02 / 2009 



faction Dexia vaut 4.56 n 
faction Dexia vaut 4.72 n 
L'obligation EdF a 3.8 % vaut 55 a 
L'obligation EdF a 3.8 % vaut 56 a 



lis confirment que l'appel des methodes de meme nom sont bien appliquees au type 
d' objet adequat. 



Utilisation des alias 

En combinaison avec l'utilisation du mot-cle use, il est possible de creer des alias des 
noms des namespaces avant de creer les objets representant une action ou une obligation. 
Nous obtenons de cette facon une variante de l'exemple 9-20 dans l'exemple suivant : 

■ : *~ Exemple 9-21 Utilisation d'alias 

<?php 

require 'objetl8.php' ; 

require 'objetl9.php' ; 

//Objet Action 

use Bourse: :Action: :Valeur as aValeur;<— © 

$action = new aValeur( "Dexia" ,4.56) ; <—© 
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$action->info( ) ; 

$action->changeCours(4.72); 

$action->info( ) ; 

//Ob jet Obligation 

use Bourse: :0bl igation: :Valeur as oValeur;<— © 

$oblig = new oValeur( "EdF" ,55,3.8) ; <— © 

$oblig->info( ) ; 

$obl ig->changeCours(56) ; 

$oblig->info( ); 

?> 

La classe Valeur du namespace Bourse — Action y est aliasee avec le nom aValeur 
(repere ©) et celle du namespace Bourse: : Obi igation avec le nom oValeur (repere ©). 
C'est alors en utilisant ces alias de nom de classe que nous pouvons creer les objets desi- 
res (repere Q et ©). 



Methodes magiques 



Toutes les methodes dont les noms commencent par deux caracteres de soulignement 

sont des methodes dites « magiques », dont la creation est reserve a PHP et qui ont des 

roles particuliers. Nous en avons deja rencontre deux: constructO et destructO, 

respectivement constructeur et destructeur, appelees automatiquement lors de la creation 
ou la destruction d'un objet. PHP en comporte d'autres qui sont appelees automatique- 
ment dans des circonstances donnees, a savoir : 

• set() est executee quand le script tente de modifier une propriete declaree private 

ou protected. 

• get() est executee lorsque le script tente de lire une propriete declaree private ou 

protected. 

• i sset( ) est executee quand le script tente de verifier, avec les fonctions i sset( ) ou 

empty( ), si une propriete declaree private ou protected existe ou est vide. 

• unsetO est executee quand le script tente de supprimer une propriete declaree 

private ou protected avec la fonction unsetO. 

L'exemple 9-22 fournit des applications de ces methodes. La classe macl asse possede une 
propriete code declaree private, done normalement inaccessible a partir d'un objet 
(repere ©). Le constructeur permet d'affecter une valeur a cette propriete (repere ©). 

Les methodes magiques set(), get(), issetO et unsetO (reperes ©. ©, ©et©) 

creent chacune une action qui est declenchee respectivement quand le script affecte une 
valeur a la propriete code, tente de la lire, verifie son existence ou veut la supprimer. Sans 
la definition de ces methodes, toutes ces actions declencheraient une erreur. Pour le veri- 
fier nous creons un objet de type macl asse (repere ©), puis nous ecrivons le code qui va 
declencher chacune des methodes magiques (reperes ©, ©, flj), ©, ©, © et ©). Notez 
que les methodes definies ici autorisent ces operations, mais que leur code pourrait affi- 
cher des messages interdisant toute modification de la propriete code qui est privee. 
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Exemple 9-22 Mise en ceuvre des methodes magiques 

<?php 

class maclasse 



private $code ; <— O 

public function constructdval ) <— © 

$this->code - $val ; 

public function set($prop, $val) <— © 

echo "Affectation de la valeur $val a la propriete $prop <br /> "; 
$this->$prop = $val ; 

public function get($prop) <— © 

return $this->$prop; 

public function isset( $prop) <— @ 

if (isset($this->$prop) ) echo "La propriete $prop est definie<br />" 

else echo "La propniete $prop n'est pas definie <bn />"; 

public function unset($prop) <— 

echo "Effacement de la prop $prop <br />"; 
unset($this->$prop); 



//Creation d'un objet 

$obj = new maclasse( 'AZERTY' ) ; <— Q 

echo isset($obj->code) ; <— © 

echo "code = ", $obj->code," <br />";<—© 

$obj->code="QWERTY"; <-© 

echo "code = ", $obj->code," <br />";<—© 

echo isset($obj->code) ; <— © 

unset($obj->code) ; <— © 

echo "code = ", $obj->code," <br />";<—© 

?> 

Le script affiche les resultats suivants : 

La propriete code est definie 
code = AZERTY 
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Affectation de la valeur QWERTY a la propriete code 

code = QWERTY 

La propriete code est definie 

Effacement de la prop code 

code = 



Memo des fonctions 



boolean class_exists (string $nomclasse) 

Determine si la classe passee en parametre existe ou non. 

string get_class(object $varobjet) 

Retourne le nom de la classe dont I'objet est une instance. 

array get_cl ass_methods(string nom_classe) 
array get_cl ass_methods( object $varobjet) 

Retournent un tableau contenant tous les noms des methodes de la classe ou de I'objet. 

array get_class_vars(string nom_classe) 

Retourne un tableau associatif dont les cles sont celles des proprietes de la classe et contenant toutes valeurs par defaut 
de ces proprietes. 

array get_decl ared_cl asses ( ) 

Retourne un tableau de tous les noms des classes du script et des classes predefines par PHR 

array get_declared_interfaces( ) 

Retourne un tableau de tous les noms des interfaces du script. 

array get_object_vars (object $varobjet) 

Retourne un tableau de toutes les proprietes de I'objet. 



string get_parent_cl ass(string nom_classe) 
string get_parent_cl asstobject $varobjet) 

Retourne le nom de la classe parente d'une classe ou d'un objet. 

bool method_exists (object $object, string $nommethode ) 

Determine si la methode precisee en parametre existe ou non. 

bool is_subclass_of (divers $object, string Snomclasse ) 

Determine si I'objet precise a la classe $nomcl asse comme parent. 



Exercices 



Exercice 1 

Ecrivez une classe representant une ville. Elle doit avoir les proprietes nom et departement et 
une methode affichant « la ville X est dans le departement Y ». Creez des objets ville, 
affectez leurs proprietes, et utilisez la methode d'affichage. 
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Exercice 2 

Modifiez la classe precedente en la dotant d'un constructeur. Realisez les memes opera- 
tions de creation d'objets et d'affichage. 

Exercice 3 

Creez une classe representant une personne. Elle doit avoir les proprietes nom, prenom et 
adresse, ainsi qu'un constructeur et un destructeur. Une methode getPersonneO doit 
retourner les coordonnees completes de la personne. Une methode setAdresseO 
doit permettre de modifier l'adresse de la personne. Creez des objets personne, et utilisez 
1' ensemble des methodes. 

Exercice 4 

Creez une classe nominee form representant un formulaire XHTML. Le constructeur doit 
creer le code d'en-tete du formulaire en utilisant les elements <form> et <fieldset>. Une 
methode setText( ) doit permettre d'ajouter une zone de texte. Une methode setSubmitt ) 
doit permettre d'ajouter un bouton d' envoi. Les parametres de ces methodes doivent 
correspondre aux attributs des elements XHTML correspondants. La methode getFornK ) 
doit retourner tout le code XHTML de creation du formulaire. Creez des objets form, et 
ajoutez-y deux zones de texte et un bouton d'envoi. Testez l'affichage obtenu. 

Exercice 5 

Creez une sous-classe nominee form2 en derivant la classe form de l'exercice4. Cette 
nouvelle classe doit permettre de creer des formulaires ayant en plus des boutons radio et 
des cases a cocher. Elle doit done avoir les methodes supplementaires qui correspondent 
a ces creations. Creez des objets, et testez le resultat. 

Exercice 6 

Creez un objet a partir de la classe f orm2 de l'exercice 5, puis creez-en un clone. Modifiez 
certaines caracteristiques de cet objet, et affichez les deux formulaires obtenus. 

Exercice 7 

Creez une classe abstraite representant une personne. Elle declare les proprietes nom et 
prenom et un constructeur. Creez une classe cl ient derivee de la classe personne en y ajou- 
tant la propriete adresse et une methode setCoord( ) qui affiche les coordonnees completes 
de la personne. Creez une classe el ecteur derivee de la meme classe abstraite, et ajoutez- 
y deux proprietes bureau_de_vote et vote, ainsi qu'une methode avoter( ), qui enregistre si 
une personne a vote dans la propriete vote. 

Exercice 8 

Creez deux namespaces, nommes Firme: : Client et Firme: Commercial, possedant chacun 
des classes Personne. Chacune d'elles doit avoir des proprietes pour enregistrer les coor- 
donnees de la personne et son code, un constructeur et des methodes set( ) et get( ) pour 
pouvoir modifier et afficher les proprietes. Creez ensuite des objets representant deux 
clients et un commercial. 
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Exercice 9 

Integrez les methodes magiques connues a au moins une des classes de l'exercice 8 apres 
avoir declare la propriete code comme protected. 
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Les images dynamiques 



PHP permet non settlement de creer des pages contenant du texte affiche dynamiquement 
mais egalement des images dynamiques en fonction des besoins. Vous allez voir comment 
creer des images dynamiques aux formats GIF, JPEG, PNG et meme WBMP a destination 
des terminaux mobiles. 

PHP est livre avec l'extension GD (Graphic Device). La version actuelle, livree avec 
PHP 5, vous permet de creer des images aux formats GIF, JPEG, PNG et WBMP. 

Pour verifier si l'extension est installee sur votre serveur, utilisez la fonction phpi nf o ( ) , et 
reportez-vous a la rubrique GD, qui contient le numero de version et differentes caracte- 
ristiques, en particulier la possibilite d'utiliser des polices TrueType pour ecrire du texte 
dans une image. Vous pouvez egalement utiliser la fonction gd_info(), qui retourne un 
tableau contenant les caracteristiques de l'extension. 



Principes generaux 

Sur le serveur local installe par Wampserver, l'extension GD est installee par defaut. 

Sur un serveur sur lequel elle ne serait pas disponible, vous devez decommenter la ligne 
suivante en supprimant le point- virgule place au debut de la ligne : 

extension=php_gd2.dl 1 

Cette ligne se trouve dans le fichier php.ini, situe dans le dossier C:\wamp\bin\apache\ 
apache2.2.8\bin dans lequel a ete effectuee l'installation. L'affichage realise par le script 
contenant la fonction phpinfoO vous confirme que la bibliotheque GD est desormais 
utilisable. 
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Les scripts de creation d'image doivent suivre les etapes suivantes : 

1. Envoi d'un en-tete precisant le type d'image qui sera envoye du serveur vers le navi- 
gate ur. Vous retrouvez ici la fonction header ( ) sous la forme suivante pour une image 
de type PNG : 

header (" Content-type :image/png") ; 

Selon le format choisi, vous pouvez remplacer le type MIME de l'image par image/ 
jpeg, image/gif ou image/vnd.wap.wbmp. 

2. Creation du cadre de l'image dans lequel vont etre traces les elements de l'image en 
appelant la fonction imagecreate( ), qui definit les dimensions de l'image en pixels et 
reserve l'espace memoire necessaire sur le serveur. 

3. Creation des couleurs qui vont etre utilisees pour effectuer les traces en utilisant 
les codes decimaux des couleurs RGB (Red, Green, Blue) a l'aide de la fonction 

imagecoloral locate ( ). 

4. Trace de formes geometriques dans le cadre. Les formes disponibles sont variees. 

5. Ecriture du texte dans l'image a l'aide des polices incorporees ou de polices TrueType 
ou FreeType. 

6. Envoi de l'image creee vers le navigateur ou dans un fichier image enregistre sur le 
serveur et utilisable dans n'importe quelle page ou image au moyen de l'element 
XHTML <img>. Les fonctions imagegif ( ), imagejpg( ) ou imagepng( ) peuvent etre utili- 
sees pour cela selon le format defini a l'etape 1. Ces fonctions permettent egalement 
d'enregistrer les images creees sur le serveur. 

7. Liberation facultative de l'espace memoire occupe par l'image sur le serveur a l'aide 
de la fonction imagedestroyO. 

Pour une image PNG, un script type de creation d'image dynamique a la structure illus- 
tree a l'exemple 10-1. 

Exemple 10-1. Script de creation d'image 

<?php 

header ("Content-type: image/png" ) ; 
//Creation du cadre 800x400 pixels 
$idimg=imagecreate(800,400) ; 
//Creation des couleurs 

$fond=imagecolorallocate($idimg,255,255,51) ; 
$noir=imagecoloral locate($idimg, 0,0,0) ; 
//it***************** 

//TRACES DES FORMES 
//****************** 

//Enregistrement de l'image dans un fichier 
imagepng($idimg, "monimage.png") ; 
//Envoi de l'image au navigateur 
imagepng($idimg) ; 
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I //Liberation de l'espace memoire 
imagedestroy($idimg) ; 
?> 

Si la page qui affiche 1' image contient d'autres elements XHTML — comme c'est le cas 
la plupart du temps — , vous devez separer la creation de 1' image de son utilisation. Vous 
avez done deux fichiers, un fichier PHP contenant le code de creation de 1' image, a 
l'exemple du script de l'exemple 10-1, et un fichier XHTML ou PHP contenant le code 
XHTML d'utilisation de l'image, a l'exemple du fichier ci-dessous. Le nom du fichier 
PHP sera donne comme valeur a l'attribut sre de l'element <img />. 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 
<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title> Images dynamiques</title> 
</head> 
<body> 
<div> 

<h2> Une image dynamique </h2> 
<img src="monimage.php" alt="Mon image" /> 
</div> 
</body> 
</html> 

Toutes les images creees par la suite peuvent etre affichees en utilisant ce modele 
XHTML et en modifiant simplement la valeur de l'attribut src. 

Creation du cadre de l'image 

Vous utilisez ici la fonction suivante : 

| resource imagecreate ( int larg, int haut) 

qui recoit comme parametres la largeur et la hauteur de l'image en pixels et retourne un 
identifiant de type resource. Ce dernier sera utilise par toutes les fonctions intervenant 
dans la creation de l'image, soit pour definir les couleurs, soit pour y effectuer des traces, 
soit pour l'afficher ou l'enregistrer a la fin de la creation. 

Par exemple, vous ecrivez : 

$idimg= imagecreate(600,200) ; 

pour creer une image de 600 pixels de large sur 200 pixels de haut. L'image est des lors 
identifiee par la variable Sidimg. 

Ce type d'image, dite image a palette, ne contient qu'un nombre limite de couleurs, ce 
qui convient generalement aux types d'images realisees a l'aide de la bibliotheque GD. 
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Pour creer des images en TrueColor en millions de couleurs, vous pouvez utiliser la fonc- 
tion suivante : 

| resource imagecreatetruecolor ( int larg, i nt haut) 

La fonction imagei struecol or( ) permet de verifier si une image est de ce type TrueColor. 
Elle retourne TRUE si c'est le cas et FALSE dans le cas contraire. Sa syntaxe est la suivante : 

bool imagei struecol or ( resource $idimg) 

II est envisageable d' utiliser des images existantes pour y effectuer des ajouts, que ce soit 
des legendes ou des traces geometriques. II est, par exemple, possible de creer un cadre a 
partir de ces images en utilisant l'une des fonctions suivantes, selon leur format : 

resource imagecreatef romgif ( string nom_image) 

resource imagecreatef romjpeg ( string nom_image) 

resource imagecreatef rompng ( string nom_image) 

resource imagecreatef romwbmp ( string nom_image) 

Chacune de ces fonctions admet comme parametre un nom de fichier ou l'URL complete 
du fichier image entre guillemets. Elles retournent un identiflant de type resource. 

Pour utiliser ces images existantes, il peut etre utile d'en connaitre certaines caracteristi- 
ques, comme les dimensions, afin, par exemple, d'ecrire un texte centre dans l'image. 
Pour obtenir ces informations, vous pouvez faire appel a la fonction suivante : 

| array getimagesize ( string nom_image) 

qui retourne un tableau a sept elements. 

Les elements de ce tableau sont les suivants : 

• L' element d'indice contient la largeur de l'image en pixels. 

• L' element d'indice 1 contient la hauteur de l'image. 

• L' element d'indice 2 contient un entier qui donne le type de l'image : 1 = GIF, 
2 = JPG, 3 = PNG, 5 = PSD, 6 = BMP, 7 = TIFF (ordre des octets Intel), 8 = TIFF 
(ordre des octets Motorola), 9 = JPC, 10 = JP2, 11=JPX, 12 = JB2, 13 = SWC et 
14 = IFF. 

• L'element d'indice 3 contient une chaine utilisable dans l'element HTML <img> pour 
definir ses attributs, sous la forme width="165" height="110". 

• L'element de cle bits indique le nombre de bits utilise pour chaque couleur pour les 
images JPEG. 

• L'element de cle channel s vaut 3 pour les images RGB et 4 pour les images CMYK. 

• L'element de cle mi me contient une chaine utilisable pour creer l'en-tete correct avec la 
fonction headerO. 

En ecrivant, par exemple, le code suivant : 

print_r( get images ize( "mon_image.jpg" ) ) ; 
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vous obtenez le resultat suivant : 



Array 



[0] => 165 

[1] => 110 

[2] => 2 

[3] => width="165" hei ght=" 110" 

[bits] => 8 

[channels] => 3 

[mime] => image/jpeg 



Creation des couleurs 

La fonction suivante definit les couleurs qui seront utilisees pour le fond de 1' image et les 
traces successifs : 

int imagecoloral locate ( resource $idimg, int R, int G, int B) 

Elle cree une couleur pour l'image identifiee par $idimg. Les parametres R, G et B sont les 
valeurs entieres en base 10 (done de a 255) et non en hexadecimal (de la forme FF), 
comme en XHTML. 

Chaque valeur correspond a l'intensite des couleurs (Red, Green, Blue) qui composent la 
teinte desiree. La fonction retourne egalement un identifiant entier, qui est recupere dans 
une variable et qui servira a identifier la couleur dans les fonctions de trace. 

Par exemple, vous ecrivez : 

$orange=imagecoloral 1 oca te($idimg, 255, 128.0) ; 
pour creer la couleur orange qui sera identifiee par la variable $orange. 



Couleur de fond 

La premiere couleur creee devient automatiquement la couleur de fond de l'image. II faut done veiller a 
I'ordre de creation des couleurs. 



Pour avoir un fond transparent, vous definissez la couleur de fond comme etant transpa- 
rente a l'aide de la fonction : 

int imagecolortransparent ( resource $idimg, int $couleur) 

qui permet d'obtenir une image de forme quelconque, le cadre rectangulaire n'etant plus 
visible. La couleur de transparence n'est bien sur plus utilisable pour aucun trace, sauf 
pour creer des effets particuliers. 

II est possible de definir n'importe quelle couleur comme transparente. Le code suivant 
definit le vert comme transparent : 
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I $vert=imagecolorallocate($idimg, 0,128,0) ; 
imagecolortransparent($idimg,$vert) ; 

Tous les pixels verts laissent ainsi voir la couleur de fond. 



Trace de formes geometriques 

Tous les traces de formes geometriques se font en precisant des coordonnees relativement 
au cadre qui a ete defini par la fonction imagecreate( ). L'origine des coordonnees est le 
sommet superieur gauche du cadre, le sens positif des ordonnees etant vers le bas. 

Trace de points 

Vous pouvez tracer un point de la taille d'un pixel en precisant ses coordonnees dans le 
cadre a l'aide de la fonction suivante : 

int imagesetpixel ( resource $idimg, int x, int y, int Scouleur) 

L'exemple 10-2 utilise cette fonction pour realiser le trace d'une fonction classique. La 
structure du script est conforme au modele propose precedemment et n'a pas besoin d'etre 
detaillee. Apres la creation d'une couleur de fond et d'une couleur de trace (reperes Q 
et ©), une boucle trace des points dont l'ordonnee $y est calculee a l'aide de la fonction 
sinus. La mise a l'echelle des coordonnees et le decalage d'origine sont realises dans le 
calcul de $y (repere ©). Le double appel a la fonction imagesetpixel ( ) permet d'avoir un 
trait plus epais (reperes © et ©). L' image est d'abord enregistree dans le fichier 
sinus.png (repere ©) puis envoy ee au navigateur (repere ©). et la me moire est liberee 
(repere @). 

: *~ Exemple 1 0-2. Trace d'une sinusoTde point par point. 

<?php 

header ("Content-type: image/png" ) ; 

$idimg=imagecreate(800,400) ; 

$fond=imagecolorallocate($idimg,255,255,51) ; <— O 

$noir=imagecoloral locate($idimg, 0,0,0) ; <— © 

for($x=0;$x<800;$x++) 



( 



$y=-200*sin($x/100)+200; <-© 
imagesetpixel ($idimg,$x,$y ,$noir) ; <— O 
imagesetpixel ($idimg,$x,$y+l,$noi r) ; <— © 



} 

imagepng($idimg, "sinus.png") 
imagepng($idimg) ; <— © 
imagedestroy($idimg) ; <— © 
?> 



^0 



La figure 10-1 illustre le resultat obtenu en appelant le fichier PHP dans un document 
XHTML contenant la ligne de code suivante : 



<img src="image2.php" border="l" alt="La fonction Sinus" /> 
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Figure 10-1 

Trace de la fonction sinus point par point 



Trace de droites 

Le trace de segment de droite se realise a l'aide de la fonction imagelineO, dont la 
syntaxe est la suivante : 

int imageline (resource $idimg, int xl, int yl, int x2, int y2, int Scouleur) 

Les couples (xl.yl) et (x2,y2) sont respectivement les coordonnees de l'origine et de 
l'extremite du segment. 

Par defaut, l'epaisseur des lignes est de un pixel, mais vous pouvez modifier cette valeur 
en utilisant la fonction suivante : 

| bool imagesetthickness (resource $idimg, int N) 

dans laquelle N definit la largeur de trait en pixel. Elle retourne TRUE si le parametrage est 
bien realise, FALSE sinon. 

L'exemple 10-3 definit une largeur de trait de deux pixels (repere Q) puis realise, dans 
un cadre de 800 sur 400 pixels, une serie de lignes dont l'origine est commune — le 
point de coordonnees (400,399) — et dont l'extremite est une variable de coordonnees 
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($x,0). La variable $x est incrementee de 10 unites dans la boucle for (repere ©). Le 
trace des lignes est effectue avec la couleur noire (repere ©). 

Vous obtenez une sorte d'eventail, comme l'illustre la figure 10-2. 



Exemple 10-3. Trace de lignes 

<?php 

header ("Content-type: image/png" ) ; 

$idimg=imagecreate(800,400); 

$fond=imagecolorallocate($idimg,255,255,51) ; 

$noir=imagecoloral locate($idimg, 0,0,0) ; 

//Definition de l'epaisseur de trait de 2 pixels 

imagesetthickness($idimg,2) ; <— O 

//Trace des droites 

for($x=0;$x<800;$x+=10) ^© 



( 



imagel ine ($idimg, 400,399, $x,0,$noir); <— © 



} 

imagepng($idimg, "rayons.png") ; 
imagepng($idimg) ; 
imagedestroyCSidimg) ; 
?> 
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Figure 10-2 

Trace de lignes droites 
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Trace de rectangles et de carres 

Pour tracer des rectangles et des carres, vous disposez de la fonction suivante : 

int imagerectangle (resource $idimg, int xl, int yl, int x2, int y2,int Scouleur) 

qui trace un rectangle ayant pour sommet superieur gauche le point (xl.yl) et pour 
sommet inferieur droit le point ( x2 , y 2 ) . Le trace est realise avec la couleur precisee par le 
parametre Seoul eur. 

Pour tracer des rectangles pleins avec une couleur donnee, vous disposez de la fonction 
suivante, a la syntaxe identique : 



\: 



nt imagefil ledrectangle (resource $i dimg , int xl, int yl, int x2, int y2, 
int Scouleur) 



L'exemple 10-4 effectue le trace de rectangles imbriques a l'aide d'une boucle for 
(repere Q) P u i s d'un rectangle plein de couleur rouge au centre (repere ©). Comme les 
precedents, il enregistre 1' image sur le serve ur (repere ©) puis l'envoie au navigate ur 
(repere 0). 

Exemple 10-4. Trace de rectangles 

<?php 

header ("Content-type: image/png") ; 

$idimg=imagecreate( 800,400); 

$fond=imagecolorallocate($idimg,255,255,51); 

$rouge=imagecoloral locate($i dimg, 255, 0,0) ; 

//Definition de l'epaisseur de trait de 3 pixels 

imagesetthickness($idimg,3) ; 

//Trace des rectangles 

for($i=3;$i<100;$i+=20) 

{ 

imagerectangle($idimg,$i ,$i ,800-$i ,400-$i ,$rouge) ; <— O 
} 

//Trace d'un rectangle plein 

imagefil ledrectangle ($i dimg, 100, 100, 700, 300, Srouge); <— Q 
imagepng($idimg, "rectangles.png") ; <— © 
imagepng($idimg) ; <— © 
imagedestroy($idimg) ; 
?> 

La figure 10-3 permet d'apprecier le resultat affiche. 

Trace de polygones 

La fonction suivante permet de tracer des polygones avec un nombre quelconque de 
cotes : 

int imagepolygon (resource Sidimg, array Stab, int N, int Scouleur) 
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Figure 10-3 

Trace de rectangles 



Contrairement au trace des rectangles, vous n'enumerez pas les coordonnees des 
sommets. Celles-ci sont passees sous la forme d'un tableau $tab, dont les elements sont 
une suite d'abscisses et d'ordonnees. Assurez-vous qu'il y ait un nombre pair de coor- 
donnees. Le parametre N indique le nombre de sommets, ce qui permet de refermer la 
figure sans donner a nouveau les coordonnees du premier point. 

La variante suivante, dont la syntaxe est identique, permet de tracer des polygones pleins : 

int imagefil ledpolygon (resource $i dimg , array Stab, int N, int Scouleur) 

L'exemple 10-5 definit un tableau de huit elements representant les coordonnees de 
quatre sommets (repere Q) P u i s trace le quadrilatere correspondant (repere ©). Les 
coordonnees peuvent etre passees en definissant le tableau directement comme second 
parametre de la fonction (repere ©), ici pour tracer un triangle. 

Exemple 10-5. Trace de polygones 

<?php 

header ("Content-type: image/png" ) ; 

$idimg=imagecreate(800,400) ; 

$f ond=imagecol oral locate($i dimg, 255, 255, 51) ; 

$noir=imagecoloral locate($i dimg, 0,0,0) ; 

$bl anc=imagecol oral locate($i dimg, 255, 255, 255) ; 
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//Definition de l'epaisseur de trait de 3 pixels 

imagesetthickness($idimg,3) ; 

//Coordonnees du quadrilatere 

$tab=array (100,50,500,100,750,300,50,350); <-© 

//Trace du quadrilatere 

imagepolygon($idimg,$tab,4,$noi r) ; <— © 

//Trace du triangle plein 

imagefilledpolygon($idimg,array(150, 80,500, 150,250,310) ,3, $blanc) ; ^© 

imagepng($idimg, "polygon.png") ; 

imagepng(Sidimg) ; 

imagedestroy($idimg) ; 

?> 

Le resultat affiche est illustre a la figure 10-4. 
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Figure 10-4 

Trace de polygones 



Trace d'arcs, de cercles et d'ellipses 

Pour tracer des arcs de cercle ou des ellipses, vous disposez de la fonction imagearcO, 
dont la syntaxe est la suivante : 



|: 



nt imagearc (resource $idimg, int Xc, int Yc, int Larg, int Haut, int Angl, 
int Ang2, int Scouleur) 
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Les parametres Xc et Yc sont les coordonnees du centre. Larg et Haut representent la 
largeur et la hauteur (egaux pour un cercle). Angl et Ang2 sont des angles en degres, qui 
permettent d'indiquer la portion de cercle ou d'ellipse qui sera representee. L'origine des 
angles est la position horaire 3 heures, et le sens positif est horaire. 

Pour creer des secteurs circulaires ou elliptiques pleins, vous utilisez la fonction 

imagef i 1 1 edarc( ), dont la syntaxe est quasiment identique : 

Ibool imagefilledarc ( resource $idimg, int Xc, i nt Yc, i nt Larg, int Haut, 
**int Angl, int Ang2, int $couleur, int style) 

Le parametre supplementaire styl e est une constante entiere, qui peut prendre les valeurs 
suivantes : 

• IMG_ARC_PIE : le secteur est plein, et les rayons sont traces. Vous obtenez un camem- 
bert. 

• IMG_ARC_NOFI LL : seul le contour est trace sans les rayons. Dans ce cas, vous utilisez de 
preference imagearcO. 

• IMG_ARC_CHORD : les rayons et la corde qui relie les extremites de l'arc sont traces, et le 
complement du secteur trace est rempli. Vous obtenez un triangle isocele dont vous 
connaissez Tangle au sommet. 

Pour tracer des cercles ou des ellipses complets, il est plus simple d'utiliser la fonction 
suivante : 

I int imageel 1 ipse (resource $idimg, int Xc, int Yc, int Larg, int Haut, 
*int Scouleur) 

dont la syntaxe est similaire a imagearcO. 

Pour effectuer le meme trace plein, vous disposez aussi de la variante suivante : 

kbool imagefilledel 1 ipse (resource $idimg, int Xc, int Yc, int Larg, int Haut, 
*»$couleur) 

L'exemple 10-6 utilise ces fonctions pour tracer successivement deux cercles concen- 
triques (repere ©). un secteur elliptique plein (repere ©), une ellipse (repere ©) et une 
ellipse pleine (repere ©). 



Exemple 10-6. Trace d'arcs et d'ellipses 

<?php 

header ("Content-type: image/png" ) ; 

$idimg=imagecreate(800,400) ; 

$fond=imagecolorallocate($idimg,255,255,51) ; 

$noir=imagecoloral locate($idimg, 0,0,0) ; 

$rouge=imagecoloral locate($idimg,255,0,0) ; 

//Trace d'arcs 

imagearc($idimg,200,100,180,180,180,360,$noir); <— Q 

imagearc($idimg,200,100,140,140,180,360,$noir); 

imagef illedarc($idimg, 500. 200. 480. 300,0, 290, $rouge,IMG_ARC_PIE); <-© 
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//Trace d'ellipses 

imageellipse ( $i dimg , 200 , 150 , 100 , 50 , $noi r) ; <— © 

imagefil ledel 1 ipse ($idimg,120,300.200.80.$rouge) ; ^© 

imagepng($idimg, "cercle.png") ; 

imagepng(Sidimg) ; 

imagedestroy($idimg) ; 

?> 

La figure 10-5 illustre les resultats obtenus. 
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Figure 10-5 

Trace de cercles et d'ellipses 



Remplissage de surfaces 

Vous avez vu comment creer des surfaces pleines quand il s'agit de rectangles, de poly- 
gones ou de cercles. Quand il s'agit de remplir des formes quelconques limitees par un 
contour ferme avec une couleur precise, utilisez la fonction suivante : 

int image-fill (resource $i dimg , int x, int y, int Scouleur) 

Les coordonnees (x,y) passees en parametre sont celles d'un point quelconque de l'inte- 
rieur de la surface a remplir. 

Vous avez egalement la possibilite de remplir une surface a l'aide d'un motif constitute 
d'une image existante, qui se repete autant de fois que necessaire. Cette fonction est tres 
utile pour realiser une image de fond dans un document XHTML. 
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Commencez par charger l'image du motif, et recuperez son identifiant dans une variable, 
comme ci-dessous : 

$idmotif=imagecreatef romgif( "php5_logo.gif") ; 

Utilisez ensuite la fonction suivante : 

int imagesettile ( resource $idimg, resource lidmotif) 

qui definit l'image identifiee par $idmotif comme motif deremplissage. La valeur retour- 
nee par cette fonction est du meme type qu'un identifiant de couleur. Pour utiliser ce 
motif de remplissage, passez a la place du nom de la couleur le parametre IMG„C0L0R_ 
TILED, qui est une constante. 

Par exemple, vous ecrivez le code suivant pour creer un rectangle rempli avec le motif 
choisi : 

| imagefilledrectangle($idimg,100,300,200,390,IMG_COLOR_TILED); 

L'exemple 10-7 met en oeuvre ces fonctions de remplissage. Le trace de deux arcs de 
cercle (reperes O et 0) cree une surface qui est remplie en noir (repere ©). Vous 
chargez ensuite l'image GIF du logo PHP 5 identifiee par la variable $idlogo 
(repere ©). Cette image permet de definir le motif de remplissage au moyen de la 
fonction imagesettileO (repere©). Le passage de l'argument IMG_C0L0R_TI LED a 
la fonction imagefilledarcO permet de remplir la surface creee avec l'image du logo 
(repere 0). 

Exemple 10-7. Remplissage de surfaces 

<?php 

header ("Content-type: image/png" ) ; 

$idimg=imagecreate(800,400); 

$fond=imagecolorallocate($idimg,255,255,51) ; 

$noir=imagecoloral locate($idimg, 0,0,0) ; 

//Trace d'arcs 

imagearc($idimg,50,200,180,180,270,90,$noir); <— Q 

imagearc($idimg, 150,200, 180, 180,90,270, $noir); <— © 

//Remplissage en noir de la zone 

imagefill($idimg,100,200,$noir); <— © 

//Trace de camembert rempli avec une image 

$idlogo=imagecreatefromgif ("php5_logo.gif") ; <— O 

$motif=imagesettileC$idimg,$idlogo) ; <— © 

imagefilledarc($idimg.500.200.480.300.30,290,IMG_COLOR_TILED,IMG_ARC_PIE); ^© 

imagepng($idimg, "rempl issage.png" ) ; 

imagepng($idimg) ; 

imagedestroyCSidimg) ; 

?> 

La figure 10-6 illustre le resultat de ce script. 



Les images dynamiques 

Chapitre 10 







£J7eiu«ie 



Figure 10-6 

Remplissage de surfaces 



Ecriture de texte 



Les traces geometriques que vous venez de voir peuvent etre utilement completes par des 
legendes. L'extension GD offre la possibilite d'utiliser des polices ordinaires incorpo- 
rees, ainsi que des polices TrueType. Ces dernieres necessitent la presence des fichiers 
correspondants, avec l'extension .ttf, sur le serveur. 

La fonction imagestringO permet d'utiliser les polices de PHP. Sa syntaxe est la 
suivante : 



I* 



int imagestring (resource $idimg, int taille, int x, int y, string $ch, 
int Scouleur) 



La fonction affiche dans 1' image le texte de la chaine $ch a la position (x,y) et avec la 
couleur precisee. Le parametre tai 1 1 e definit le corps de la police utilisee, de 1 a 5. 

Pour afficher du texte verticalement de bas en haut, utilisez la fonction : 



nt imagestringup (resource $idimg, int taille, int x, int y, string $ch, 
int Scouleur) 



: 

dont la syntaxe est identique. 

L'eventail de polices disponibles dans l'extension GD est tres limite. Pour afficher des 
caracteres dans des failles ou des polices plus variees, il est preferable d'utiliser des polices 
TrueType a l'aide de la fonction suivante : 



" 



rray imagettftext (resource $idimg, int taille, int angle, int x, int y, 
int $couleur, string nom_police, string $ch) 
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Cette fonction vous permet de choisir la taille (comme dans un traitement de texte) et 
Tangle d'inclinaison du texte par rapport a l'horizontale, exprime en degres. Le nom du 
fichier de la police doit etre passe en parametre dans une chaine en y incluant son exten- 
sion ,ttf. 

Pour utiliser des polices FreeType 2, choisissez la fonction suivante, dont la syntaxe est 
identique : 



array imagefttextt resource Sidimg, int taille, i nt angle, 
**int Scouleur, string nom_police, string $ch) 



int x, int y, 



Transferts cote serveur 

La configuration PHP du serveur doit evidemment accepter de traiter les polices TrueType. Pour le verifier, 
il vous suffit d'afficher les informations foumies par la fonction phpinfo( ) dans la rubrique GD. II vous 
faut de plus obligatoirement transferer le fichier . ttf sur le serveur. 



L'exemple 10-8 realise l'affichage de texte dans une image en utilisant tout d'abord les 
cinq tailles de police PHP (reperes O a ©) puis en tracant un texte verticalement 
(repere ©) et enfin au moyen de polices TrueType horizontales (reperes Q et ©) ou 
inclinees (repere ©). La figure 10-7 illustre le resultat obtenu. La pauvrete des polices 
PHP est evidente en comparaison des polices TrueType. 

Exemple 10-8. Creation de texte dans une image 

<?php 

header ("Content-type: image/png" ) ; 

$idimg=imagecreate(800,400); 

$fond=imagecolorallocate($idimg,255,255,51) ; 

Snoir=imagecoloral locate($idimg, 0,0,0) ; 

$orange=imagecolorallocate($idimg, 255, 128,0) ; 

i magefilledrectanglet Sidimg, 50,100, 220, 390 Jorange); 

//Texte avec les polices PHP 

imagestring($idimg, 5, 55, 100, "RECTANGLE ORANGE" Jnoir) 

imagest ring (Sidimg, 4, 55, 120, "RECTANGLE ORANGE" Jnoir) 

imagest ring (Sidimg, 3, 55, 140, "RECTANGLE ORANGE" Jnoir) 

imagest ring (Sidimg, 2, 55, 160, "RECTANGLE ORANGE" Jnoir) 

imagest ring (Sidimg, 1,55, 180, "RECTANGLE ORANGE" Jnoir) 

imagest ringupt Sidimg, 5, 195, 300, "RECTANGLE ORANGE" Jnoir) ; <— Q 

//Texte avec des polices TrueType 

imagettftext (Sidimg, 30, 0,300, 100, $noir, "Elephnti .ttf " , 

'•MySQL" ); <-Q 

imagettftext (Sidimg, 35, 0,300, 240, $noi r, "Elephnt.ttf " , " 

imagettftext (Sidimg, 30,10,300,200 Jnoir, "Elephnti .ttf " , 

*•" Engels" ); <— Q 

imagepng($idimg) ; 

imagedestroyjidimg) ; 

?> 



^0 

^0 
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EYR0LLES" ); <-© 
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Figure 10-7 

Ecriture de texte dans une image 



Utilisation pratique 

L'exemple 10-9 illustre une fonction complete de creation a" image a l'aide de la bibliothe- 
que GD. La fonction cree dynamiquement un histogramme a partir de donnees extemes. 
Celles-ci peuvent provenir d'une base de donnees ou d'un fichier XML par exemple. 

La fonction possede les caracteristiques suivantes, qui la rendent utilisable dans de 
multiples cas : 

• Les dimensions de l'image sont parametrables par le biais des variables ($x,$y) 
(repere O '■ La taille de l'image est creee en fonction de ces valeurs (repere ©). 

Les donnees pour la hauteur des rectangles de l'histogramme sont en nombre variable. 
Elles sont passees a la fonction sous forme de tableau ($donn, repere Q troisieme para- 
metre). 

• Chaque rectangle de l'histogramme comporte une legende particuliere. L' ensemble de 
ces legendes est passe sous forme de tableau (Stexte, repere Q quatrieme parametre). 

• L'ensemble de l'histogramme occupe la largeur de l'image moins 20 pixels et 80 % 
de la hauteur totale pour obtenir des marges (repere ©). En fonction du nombre 
d' elements du tableau $donn, vous calculez le nombre de colonnes (repere ©) et la 
largeur de chacune d'elles (repere ©). 
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• Une boucle for effectue le calcul des coordonnees des rectangles en fonction des 
donnees et du coefficient de mise a l'echelle (repere Q ). Une seconde boucle trace les 
rectangles en noir, les remplit en jaune et ecrit le libelle de chaque colonne (repere ©). 

• L'histogramme a un titre general ($t1 tre, repere O cinquieme parametre), qui est ecrit 
avec une police TrueType (repere 0). 

• La fonction n'envoie pas 1' image creee directement au navigateur, a la difference 
des exemples precedents, mais enregistre un fichier image sous le nom histo.png 
(repere ©). Celui-ci est utilisable dans une page XHTML contenant l'element <i mg />. 

Exemple 10-9. Fonction de creation d'un histogramme dynamique 

<?php 

function histo($x,$y ,$donn,$texte,$titre) <— © 



{ 



$image=imagecreate($x,$y) ; <— © 

//la premiere couleur declaree est la couleur de fond 

$ocre=imagecol oral locate ($i mage ,195, 155, 125) ; 



$blanc=imagecoloral 

$bleu =imagecoloral 

$noir =imagecoloral 

$jaune=imagecoloral 

$nbcol=count($donn) 

$maxi=0; 

//Recherche de la valeur maxi 

for($i=0;$i<$nbcol ;$i++) 



ocate($image,255,255,255); 
ocate($image, 50, 0,255); 
ocate($image, 0,0,0); 
ocate($image,255,255,00); 

^0 



max($maxi ,$donn[$i]); <— O 



//coefficient d'echelle 

$coeff = ($y*0.8)/ Smaxi ; ^0 

$X0 = 10; 

$Y0 = $y-50; 

$larg = ($x-20)/$nbcol ; <-© 

//coordonnees des sommets des rectangles 

for($i=0;$i<$nbcol ;$i++) <— Q 



$tabX[$i] = $X0 + 
$tabY[$i] = $Y0 - 



;larg*$i ; 
;coeff*$donn[$i] ; 



} 

//trace des rectangles 

for($i=0;$i<$nbcol ;$i++) <— © 

{ 

//traces des rectangles en noir 

imagerectangle($image,$tabX[$i],$tabY[$i],$tabX[$i]+$larg,$YO,$noir); 
//rempl issage des rectangles en jaune 
imagefill ( $i mage, StabX [$i ]+5,$Y0-5,$ jaune ) ; 
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//Ecriture des donnees au dessus des rectangles 

imagettftext($image,15,0,$tabX[$i]+20,$tabY[$i]-5,$noir,"vivaldii.ttf", 

*$donn[$i]); 

//Ecriture des jours en bas des rectangles 

imagettftext($image,15,0,$tabX[$i]+20,$y-55,$bleu,"elephnti.ttf", 

*$texte[$i]) : 
} 

//Ecriture du titre de 1 'histogramme en bas 

imagettf text (Simage, 20,0, 200, $y-23, Sblanc, "elephnti .ttf " ,$titre) ; <^© 
//enregistre 1 ' image 
imagepng( Simage, "histo.png") ; <— © 
//Libere la memoire 
imagedestroy($image) ; 
} 
?> 

L'exemple 10-10 utilise cette fonction pour creer une page HTML incluant un script 
PHP qui incorpore le code image9.php de la fonction histoO (repere ©) P u i s definit le 
tableau de donnees et les legendes contenues dans les variables $donn, Stexte et $titre 
(reperes ©. © et ©). L'appel de la fonction histo( ) avec ces parametres cree l'image 
histo.png (repere ©). Celle-ci est appelee dans l'attribut src de l'element <img> du docu- 
ment HTML (repere ©). 

Exemple 10-10. Utilisation de la fonction 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<title> Histogramme dynamique </title> 
</head> 
<body> 
<div> 

<h2>Resul tats des ventes de la semaine</h2> 

<?php 

//Utilisation de la fonction 

includet "image9.php" ) ; <— © 

$donn= array(850, 2500, 4050, 2730, 2075, 2590, 1450); <-© 

Stexte = array ( "Lun" ,"Mar" , "Mer" ,"Jeu" , "Ven" , "Sam" , "Dim" ) ; <— © 

$titre = "Ventes hebdomadaires PHP 5";<— © 

histo(700,450,$donn,$texte,$titre); <— © 

?> 

<img src="histo.png" alt="Ventes" /> <— © 

</div> 
</body> 
</html> 
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La figure 10-8 illustre l'histogramme cree par la fonction histoO avec les donnees de 
l'exemple 10-10. 
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Figure 10-8 

Histogramme des ventes 



L'extension Ming et les animations Flash 

Dans le domaine du graphisme, PHP dispose, en plus du module GD, d'un module Ming 
installe d'office dans WampServer et sur les serveurs d'hebergeurs comme Ovh. Ce 
module permet la creation dynamique d'animations au format Flash (avec l'extension 
.swf). II est utilisable aussi bien sous Windows que sous Linux et permet, a l'instar du 
logiciel Flash d'Adobe, de gerer des formes, des boutons, des images mais aussi des 
textes et de repondre aux actions des utilisateurs dans les animations realisees. II permet 
egalement de gerer la diffusion de videos et de fichiers sons au format MP3. 

Le module Ming est entierement oriente objet et met a votre disposition 18 classes 
auxquelles sont associees au total plus de 160 methodes. La pagination de ce livre ne 
nous permet pas d'envisager serieusement une etude de ce module mais, si le sujet vous 
interesse, vous trouverez en bonus, sur le site du livre, a l'adresse http://www.funhtml.com/ 
php5/C10/Ming une initiation a l'utilisation des classes de Ming ainsi que des exemples de 
creation de fichiers Flash. 
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Memo des fonctions 



array gd_info (void ) 

Retourne les informations concernant la version GD du serveur. 

array getimagesize ( string nom_image) 

Retourne des informations sur I'image. 

int imagearc (resource $i dimg . int Xc, int Yc, int Larg, int Haut. int Angl, int Ang2, int 
$couleur) 

Cree un arcdecercle ou une ellipse de centre (Xc.Yc). 

int imagecolorallocate ( resource $i dimg , int R, int G, int B) 

Cree une couleur RGB et retourne un identifiant. 

int imagecolorat ( resource $idimg, int X, int Y) 

Retourne I'identifiant de la couleur du pixel situe en ( X , Y ) . Pour une image TrueColor, retourne le code de couleur RGB. 

int imagecolordeallocate ( resource $idimg, int $couleur) 

Supprime la couleur dont I'identifiant est Seoul eur. 

bool imagecolorset ( resource $i dimg , int $couleur, int R, int G, int B) 

Modifie la couleur dont I'identifiant est donne et retourne TRUE. 

array imagecolorsforindex ( resource $idimg, int Scouleur) 

Retourne les valeurs RGB de la couleur precisee dans un tableau. 

int imagecolorstotal ( resource $idimg) 

Retourne le nombre de couleurs de I'image. 

int imagecolortransparent ( resource $idimg, int Scouleur) 

Definit la couleur de transparence. 

int imagecopy (resource $idimg2, resource $idimgl, int x2, int y2, int xl, int yl, int largl, 
int hautl) 

Copie la partie de I'image 1 commengant au point (xl ,yl), de largeur 1 argl et de hauteur hautl, dans I'image 2 au 
point (x2,y2). 

int imagecopy (resource $idimg2, resource $idimgl, int x2, int y2, int xl, int yl, int largl, 
int hautl, int transp) 

Identique a la precedents mais en fusionnant les deux images en fonction de la transparence affectee a I'image 2 (de 
a 100). 

resource imagecreate (int larg, int haut) 

Cree une nouvelle image vide de dimensions 1 arg x haut pixels. 

resource imagecreatefromgif (string nom_image) 

Ouvre une image GIF. Le parametre peut etre une URL. 

resource imagecreatefromjpeg (string nom_image) 

Ouvre une image JPEG. Le parametre peut etre une URL. 
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resource imagecreatefrompng (string nom_image) 

Ouvre une image PNG. Le parametre peut etre une URL. 

resource imagecreatefromwbmp (string nom_image) 

Ouvre une image WBMR Le parametre peut etre une URL. 

resource imagecreatetruecolorO'nt larg, int haut) 

Cree une nouvelle image TrueColor vide de dimensions 1 arg x haut pixels. 

int imagedestroy (resource $idimg) 

Libere la memoire occupee par I'image identifiee par $idimg. 

int imageel lipse (resource $idimg, int Xc, int Yc, int Larg, int Haut, int $couleur) 

Cree une ellipse ou un cercle de centre (Xc.Yc). 

int imagefill ( resource $idimg, int X, int Y, int $couleur) 

Remplit la zone contenant le point ( X , Y ) avec la couleur donnee. 

bool imagefilledarc ( resource $idimg, int Xc, int Yc, int Larg, int Haut, int Angl, int Ang2, 
int $couleur, int style) 

Trace un secteur circulaire de centre (Xc.Yc) rempli avec la couleur donnee. 

bool imagefil ledel 1 ipse (resource $idimg, int Xc, int Yc, int Larg, int Haut,$couleur) 

Trace une ellipse de centre (Xc.Yc) remplie avec la couleur donnee. 

int imagefil ledpolygon (resource $i di mg . array Stab, int N, int Icouleur) 

Trace un polygone a N cotes dont les coordonnees des sommets sont listes dans le tableau $tab et le remplit avec la 
couleur donnee. 

int imagefil ledrectangle (resource $i dimg . int xl , int yl, int x2, int y2, int Scouleur) 

Trace un rectangle rempli avec la couleur donnee. 

int imagefontheight ( int Sidfont) 

Retourne la hauteur de la fonte en pixels. 

int imagefontwidth ( int $idfont) 

Retourne la largeur de la fonte en pixels. 

array imagefttext (resource $i dimg , int taille, int angle, int x, int y, int $couleur, string 
nom_police, string $ch) 

Affiche un texte en utilisant une police FreeType 2. 

int imagegd2 (resource $idimg [, string nom_fichier]) 

Envoie I'image GD2 vers le navigateur ou dans un fichier sur le serveur. 

int imagegif ( resource $i dimg [, string nom_fichier] ) 

Envoie I'image GIF vers le navigateur ou dans un fichier sur le serveur. 

int imageinterl ace (resource $idimg [, int N]) 

Definit I'entrelacement de I'image si W vaut 1 . Retourne I'etat d'entrelacement. 
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bool imageistruecolor (resource $idimg) 

Retourne TRUE si I'image est en TrueColor. 

i tit imagejpeg ( resource $i dimg [, string nom_fichier [, int N]]) 

Envoie I'image JPEG vers le navigateur ou dans un fichier sur le serveur. N est le facteur de qualite de a 100 (75 par 
defauf). 

int imageline ( resource $i dimg , int XI, int Yl, int X2, int Y2, int $couleur) 

Trace un segment entre les points (XI, Yl) et (X2.Y2) avec la couleur donnee. 

int imagepng ( resource $idimg [, string nom_fichier]) 

Envoie I'image PNG vers le navigateur ou dans un fichier sur le serveur. 

int imagepolygon (resource $i dimg , array $tab, int N, int $couleur) 

Trace un polygone a N cotes dont les coordonnees des sommets sont listes dans le tableau $tab. 

int imagefilledrectangle (resource $idimg, int XI, int Yl, int X2, int Y2, int $couleur) 

Trace un rectangle. 

int imagesetpixel (resource $idimg, int X, int Y, int $couleur) 

Trace un pixel au point ( X , Y ) de la couleur donnee. 

bool imagesetthickness (resource $i dimg , int N) 

Definit la largeur de trait des traces des figures geometriques. 

int imagesettile (resource lidimgl, resource $idimg2) 



Definit I'image $idimg2 comme motif de remplissage de $i dimgl. Les fonctions de remplissage doivent utiliser la cons- 
tante IMG_COL0R_TILED comme couleur. 

int imagestring (resource $i dimg , int font, int x, int y, string s, int $couleur) 

Ecrit la chaine $ch avec la taille font dans I'image $idimg a la position (x,y). 

int imagestringup (resource $idimg, int font, int x, int y, string s, int $couleur) 

Identiquea i mages tringO mais avec letexte ecrit verticalement. 

int imagesx (resource $i dimg ) 

Retourne la largeur de I'image en pixels. 

int imagesy (resource $i dimg ) 

Retourne la hauteur de I'image en pixels. 

array imagettftext (resource $i dimg , int taille, int angle, int x, int y, int $couleur, string 
nom_police, string $ch) 

Affiche un texte en utilisant une police TrueType. 

int imagetypes (void ) 

Retourne les types d'image supportes par la bibliotheque GD. Les valeurs sont 1 pour GIF, 2 pour JPG, 4 pour PNG et 8 
pourWBMR Les valeurs se cumulent (exemple5 pour GIF et PNG). 

int imagewbmp (resource $idimg [, string nom_fichier, int $couleur]]) 

Envoie I'image WBMP vers le navigateur ou dans un fichier sur le serveur. Le dernier parametre donne la couleur de fond. 
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Exercices 



Exercice 1 

Creez une image de 500 x 300 pixels avec une couleur de fond rouge. Ecrivez un texte de 
bienvenue en blanc avec une police PHP. 

Exercice 2 

Creez une image de 400 x 200 pixels avec un fond transparent. Dessinez une suite de 
rectangles emboites de couleurs differentes. 

Exercice 3 

Creez une image de 800 x 600 pixels avec une couleur de fond verte. Tracez un trapeze 
isocele rempli de jaune, et ecrivez le mot « trapeze » au centre. 

Exercice 4 

Creez une image de 601 x 601 pixels avec un fond transparent. Determinez le centre O 
de l'image, et tracez des cercles concentriques centres en O avec des rayons variant de 
30 pixels jusqu'au bord de l'image. Attribuez a chaque cercle une couleur differente. 

Exercice 5 

Creez une image a partir d'un fichier JPEG existant sur votre poste. Ecrivez une legende 
de votre choix, d'abord en noir puis dans une autre couleur, en la decalant de 1 pixel en 
X et en Y afin de creer un effet d' ombre. 

Exercice 6 

Creez une image de 1 024 x 768 pixels. Tracez la fonction f (x)=x 2 , avec x compris entre 
- 50 et + 50, et tracez les axes. Le trace doit occuper la plus grande surface possible de 
l'image. 
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Les fichiers 



Vous avez vu au chapitre 6 que les formulaires etaient l'outil privilegie pour recueillir les 
informations en provenance des visiteurs du site et que ces informations etaient recupe- 
rees dans des variables creees cote serveur. Le probleme avec ces donnees est qu'elles 
sont volatiles. Sitot le script termine, elles sont perdues. Quand elles presentent un interet 
qui va au-dela de la simple connexion en cours, il faut envisager les moyens de les reuti- 
liser plus tard. 

La solution la plus simple a ce probleme consiste a enregistrer les donnees sur le serveur 
dans un fichier, generalement de type texte. Ce type de stockage est principalement 
utilise pour des quantites de donnees de taille modeste et quand il n'est pas necessaire 
d'effectuer par la suite des recherches complexes parmi elles. Dans le cas contraire, il 
faut avoir recours a une base de donnees specialisee, comme MySQL ou SQLite, qui 
permet d'effectuer des recherches « pointues ». 

L' utilisation des bases de donnees etant relativement complexe et lourde pour les debu- 
tants, il ne faut pas negliger le stockage de donnees dans des fichiers pour les cas simples. 
Vous vous interesserez surtout dans ce chapitre aux fichiers au format texte brut, a 
l'extension .txt. Les methodes presentees s'appliquent neanmoins aux autres types de 
fichiers. Le chapitre 19 est consacre a la facon de lire les fichiers XML, pour lesquels 
PHP fournit desormais une extension specialisee, et aux echanges reciproques de 
donnees qu'il est possible de realiser entre une base de donnees comme MySQL et un 
fichier au format XML. 

Le present chapitre detaille les techniques suivantes : 

• ouverture d'un fichier existant ou creation d'un nouveau fichier puis sa fermeture ; 

• ecriture dans le fichier ; 

• formatage des donnees ; 
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lecture des donnees ; 

recueil d' informations sur les fichiers 

modification des fichiers. 



Creation, ouverture et fermeture d'un fichier 

II peut etre utile dans certaines circonstances de creer un fichier vide de tout contenu 
mais ayant une existence physique sur le serveur. Si vous envisagez d'ecrire des donnees 
correspondant a plusieurs connexions differentes dans un meme fichier, par exemple, il 
vous faut commencer par creer un fichier vide, non sans controler qu'il n'existe pas 
encore. Vous y ajoutez ensuite les donnees en provenance de l'utilisateur. 

Pour faire cela, vous pouvez detourner la fonction touch ( ) de sa vocation initiale, qui est 
de definir la date de la derniere modification d'un fichier. Si le fichier n'existe pas, cette 
fonction le cree et lui affecte la date passee en deuxieme argument sous la forme d'un 
timestamp UNIX comme date de derniere modification. 

La syntaxe generale de la fonction touch ( ) est la suivante : 

boolean touch(string "noin_fichier"[, integer timestamp]) 

Le nom du fichier vient en premier parametre, et le timestamp de la date de creation en 
second. 

En ecrivant, par exemple : 

if ( lfile_existsCmonfich.txt") ) 
{ 

touch( "monfich.txt" ,time( ) ) ; 
} 

vous creez le fichier monfich.txt s'il n'existe pas encore, avec pour date de derniere 
modification l'instant en cours donne par la fonction time( ). Le fichier est vide mais est 
disponible en ecriture, comme vous le verrez a la section suivante. 

La fonction f i 1 e_exi sts ( ) utilisee dans cet exemple retourne TRUE si le fichier existe deja 
et FALSE dans le cas contraire. 



Ouverture du fichier 

Avant de realiser des operations de lecture ou d' ecriture sur un fichier, vous devez 
l'ouvrir explicitement. Vous disposez pour cela de la fonction fopenO, qui necessite 
plusieurs parametres. Le choix de ces parametres conditionne le mode d'acces au fichier 
et ce que vous allez pouvoir en faire, a savoir le lire uniquement, y ecrire uniquement ou 
le lire et y ecrire dans le meme script. 

La syntaxe de la fonction fopen( ) est la suivante : 

resource fopen(string $nom, string mode, [boolean path]) 
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La section suivante examine le role de ces differents parametres. 

Parametres de la fonction fopen() 

Le premier parametre de la fonction fopenO est une chaine de caracteres indiquant le 
nom du fichier que vous souhaitez utiliser. Ce nom peut etre sous une forme reduite 
(le nom du fichier seul) ou developpee (le nom du fichier et son chemin d'acces 
complet). 

L'adresse du fichier peut etre un chemin relatif du type : 

"../. ./repertoi re/monf ichier.txt" 

ou une URL absolue de la forme : 

"http://www.monsite.net/repertoire/rnonfichier.txt" 

ou : 

"ftp://ftp.monsite.com/monfichier.txt" . 

Si vous n'indiquez que le nom du fichier, ce dernier doit se trouver dans le meme reper- 
toire que le script qui l'ouvre. 

Le deuxieme parametre determine le mode d'acces au fichier. Ce mode est code dans une 
chaine et peut prendre les valeurs suivantes : 

• " r" : le fichier est ouvert en lecture seule, et la lecture commence au debut du fichier. 

• "r+" : le fichier est ouvert en lecture et en ecriture, et ces operations commencent au 
debut du fichier 

• "w" : le fichier est ouvert en ecriture seule, et l'ecriture commence au debut du fichier. 

• "w+" : le fichier est ouvert en lecture et en ecriture, et ces operations commencent au 
debut du fichier 



Effacement systematique 

Pour les modes "w" et "w+", si le fichier n'existe pas il est cree automatiquement. S'il existe, son contenu 
anterieur est efface. II faut done prendre des precautions avant d'utiliser ce mode d'acces. 



• "a" : le fichier est ouvert en ecriture seule, et les donnees sont ecrites en fin de fichier, 
a la suite de celles qui existent deja ou au debut s'il est vide. Si le fichier n'existe pas, 
il est cree. 

• "a+" : le fichier est ouvert en lecture et en ecriture, et les donnees sont ecrites en fin de 
fichier, a la suite de celles qui existent deja. La lecture s'effectue a partir du debut 
du fichier. Si le fichier n'existe pas, il est cree. 

Le troisieme parametre est un booleen. S'il vaut TRUE (ou 1), la recherche du fichier est 
etendue a tous les sous-repertoires du chemin indique dans le premier parametre. S'il 
vaut FALSE, la recherche est limitee a l'emplacement indique. 
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Identifiant de fichier 

Depuis PHP 4, la fonction fopen( ) retourne un identifiant de fichier de type resource (il 
etait de type integer dans PHP 3), qui doit etre utilise comme premier parametre de la 
plupart des fonctions de manipulation des fichiers. Vous devez done imperativement 
recuperer cette valeur dans une variable pour pouvoir l'utiliser dans les autres operations 
d'acces au meme fichier. Nous noterons systematiquement cette variable $i d_f i 1 e. 

En affichant la valeur de cet identifiant, vous constatez qu'il est de la forme Resource 
id#n, dans laquelle n est un entier incremente de 1 a chaque ouverture de fichier par le 
meme script (la premiere valeur est toujours 1). Cet affichage n' a pour but que de satisfaire 
une curiosite car il ne sera jamais effectue dans un script. En cas d'echec de 1' ouverture 
du fichier, la fonction retourne la valeur FALSE, ce qui peut permettre l'affichage d'un 
message d'erreur. 

Pour ouvrir en ecriture seule un fichier existant dans le meme dossier que le script en 
cours et recuperer son identifiant, vous ecrivez, par exemple : 

|$id_file = fopen( "monfichier.txt" , "a" ) ; 
if ( !$id_file) echo "Erreur d'acces au fichier"; 

Rien n'empeche d'ouvrir plusieurs fichiers simultanement et de manipuler ainsi plusieurs 
identifiants. Vous pouvez ensuite fermer un fichier sans fermer les autres. 

Fichier temporaire 

Vous pouvez aussi creer un fichier temporaire sur le serveur a l'aide de la fonction : 

resource tmpfile( ) 

qui retourne egalement un identifiant de fichier. 

Ce fichier est utilise pour stacker des informations qui ne seront conservees que pendant 
la duree de la session ouverte par un client ou jusqu'a ce que le fichier soit explicitement 
ferme au moyen de la fonction f cl ose( ). 

Fermeture du fichier 

Apres avoir ouvert un fichier pour y effectuer des operations de lecture ou d'ecriture, il 
vous faut imperativement le fermer pour eviter tous les problemes qui pourraient resulter 
d'une tentative d' ouverture du meme fichier de la part d'un autre script ou du meme 
script ouvert par une autre connexion. 

L' operation de fermeture est realisee a l'aide de la fonction suivante : 

boolean fclose($id_file) 

Cette fonction prend comme unique parametre 1' identifiant de fichier $id_file retourne 
par la fonction fopen( ). Elle retourne la valeur booleenne TRUE si 1' operation de fermeture 
s'est bien effectuee, et FALSE dans le cas contraire. Vous pouvez done realiser un test 
systematique pour verifier le bon deroulement de l'operation de fermeture. 
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Verrouillage des fichiers 

Quand un script utilise une base de donnees telle que MySQL pour y stacker des infor- 
mations, l'ampleur du trafic sur le site n'a pas une importance primordiale. Plusieurs 
utilisateurs peuvent acceder en meme temps a la meme table et y effectuer des operations 
de lecture ou d'ecriture. MySQL se charge de gerer les priorites des operations entre 
les differentes connexions, evitant ainsi toute confusion. II n'en va pas de meme avec les 
fichiers, dont la structure est moins evoluee qu'une base de donnees. 

Si plusieurs utilisateurs accedent au meme fichier a partir du meme script ou de deux 
scripts differents et y effectuent simultanement des operations de lecture ou d'ecriture, le 
fichier risque de devenir inutilisable pour chacun d'eux. 

Afin d'eviter la corruption des fichiers qui pourrait en resulter, il est essentiel, avant 
d'ecrire ou de lire un fichier, que les scripts qui y accedent definissent une priorite 
d'acces au premier script effectuant une operation sur le fichier. Cela empeche les autres 
d'y acceder et d'y faire des modifications tant que le fichier n'est pas ferme. 

Vous disposez pour cela de la fonction f 1 ock( ), qui donne la possibilite de verrouiller le 
fichier en en bloquant partiellement ou completement l'acces pour d'autres utilisateurs 
pendant qu'un script y accede, jusqu'a ce qu'il soit ferme et done libere pour d'autres 
acces concurrents. 

La syntaxe de la fonction f 1 ock( ) est la suivante : 

boolean flock(resource $id_file,int N) 

Le premier parametre est encore 1' indispensable identificateur de fichier retourne par la 
fonction fopenO. Le second est une constante entiere nominee qui definit le mode de 
verrouillage du fichier : 

• flock($icLfile,LOCK_SH) bloque l'ecriture dans le fichier mais laisse le libre acces en 
lecture a tous les utilisateurs. La constante L0CK_SH a la valeur 1. 

• flock($id_file,LOCK_EX) bloque l'ecriture et la lecture du fichier par un autre script. Le 
script en cours a done l'exclusivite. Une tentative d'acces simultane retourne la valeur 
FALSE. La constante L0CK_EX a la valeur 2. 

• f 1 ock( $i d_f i 1 e , LOCKJJN ) libere le verrou installe precedemment. Vous ne devez surtout 
pas oublier d' effectuer cette action apres les operations realisees sur le fichier, faute de 
quoi le blocage subsiste. La constante L0CK_UN a la valeur 3. 

Vous pouvez employer les noms des constantes ou les valeurs entieres 1, 2 ou 3. Si 
plusieurs scripts differents permettent d' acceder a un meme fichier, ils doivent tous defi- 
nir des verrous sur ce fichier. II faut done utiliser systematiquement cette fonction dans 
tous les scripts. 

Si le verrouillage des fichiers presente l'avantage de la securite, il a aussi 1' inconvenient 
d'interdire les acces simultanes et de ralentir l'acces aux fichiers pour le stockage. 
L'utilisation des fichiers est done limitee aux sites qui ont un trafic limite ou aux opera- 
tions de maintenance ou de sauvegarde. 
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Compte tenu des fonctions que vous venez de voir, le schema general d'utilisation d'un 
tlchier conduit a ecrire systematiquement le code suivant : 

$id_file = fopen( "monfichier.txt" ."mode") ; 

flock($id_file,LOCK_SH ou L0CK_EX); 

//ou encore 

//flock($id_file,l ou 2); 

//operations de lecture et/ou d'ecriture 

flock($id_file(LOCK_UN); 

//ou encore 

//flock($id_file,3); 

fclose($id_file) 

Vous devrez aussi ajouter par la suite les fonctions de lecture et d'ecriture des fichiers. 



Ecriture dans un fichier 

Une fois qu'un fichier est ouvert avec fopenO, vous pouvez proceder aux operations 
d'ecriture ou de lecture de son contenu. 

Pour ecrire dans un fichier avec l'un des modes definis dans la fonction fopenO, vous 
avez le choix entre plusieurs methodes et done entre plusieurs fonctions specialisees de 
PHP. Le choix de ces fonctions s'effectue en fonction du type d'information a ecrire. 

Conserver une information 

Les fonctions fwr1te( ) et fputsO, alias l'une de l'autre, ont la syntaxe suivante : 

I integer fwrite(resource $id_file, string "chaine" [,int N]) 
integer fputstresource $id_file, string "chaine" [,int N]) 

Elles ecrivent toutes deux le texte contenu dans "chaine" dans le fichier identifie par la 
variable $id_file. Lorsque le parametre N est precise, comme ici, seuls les N premiers 
caracteres de la chaine sont ecrits dans le fichier. 

Votre premier exemple d'utilisation des fichiers est un compteur de visites tres simple 
enregistrant le nombre cumule de visites dans un fichier nomme compteur.txt. A chaque 
connexion, le script verifie si ce fichier existe deja (repere Q). 

S'il existe, le script l'ouvre en lecture (repere ©) et le verrouille en ecriture (repere ©). 
II lit ensuite dans la variable $nb la derniere valeur enregistree a l'aide de la fonction 
freadO (repere ©, que nous definirons plus avant dans les sections suivantes) l'incre- 
mente d'une unite (repere 0) et ferme le fichier (repere ©). Vous ouvrez ensuite le 
fichier en ecriture avec le mode "w", ce qui efface l'ancienne valeur (repere Q). et y ecri- 
vez la nouvelle valeur de $n (repere ©). Vous liberez ensuite le verrou et fermez le fichier 
(reperes © et ©). 

Si le fichier n'existe pas, il est cree et ouvert en ecriture (repere ©). Vous y enregistrez la 
valeur 1 ou davantage, si vous voulez faire croire que le site est tres prise. Ici $nb est 
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defini d'emblee a 10 000 visiteurs (repere ©). Vous realisez ensuite les memes opera- 
tions d'ecriture (repere ©) et de fermeture du fielder (repere ©). La derniere instruction, 
echo, affiche la valeur en cours du compteur dans un tableau (repere ©). 

Exemple 11.1. Compteur de visites a I'aide d'un fichier 

<!D0CTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 

"http://www.w3.org/tr/html4/strict.dtd"> 

<html> 

<head> 

<meta http-equiv="content-type" content= 

"text/html ; charset=iso-8859-l"> 

<title>titre</title> 

</head> 

<body> 

<?php 

if (file_exi sts( "compteur.txt") ) <— O 

{ 

if ($id_file=fopen ("compteur.txt" ,"r" ) ) <— © 

{ 

flock($id_file,l); <-© 

$nb=fread($id_file,10); <-© 

$nb++; <— © 

fclose($id_file); <-© 

$id_file=f open ("compteur.txt" , "w" ) ; <— © 

flock($id_file,l); 

fwrite($id_file,$nb); <-© 

flock($id_file,3); <-© 

fclose($id_file); <-© 

} 

else {echo «fichier introuvable" ; } 



$nb=10000; <-© 

$id_file=f open ("compteur.txt" , "w" ) ; <— © 

fwrite($id_file,$nb); <-© 

fclose($id_file); <-© 
} 

echo "<table border=\"l\" style=\"font-size:2em;\"> <tr> 
*»<td style=\"background-color:blue;color:white;\">Voici deja </td> 
<td style=\"font-size: 1.2em;background-color:white;\"> $nb </td> 
<td style=\"background-color:red;\"> visites sur le site </td></tr></table> " ; <— © 
?> 

</body> 
</html> 

La figure 11-1 presente le resultat de cet exemple, avec une petite exageration sur le 
nombre de visiteurs initial. 
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Figure 11-1 

t/w compteur de visites 

Formatage des donnees 

Vous allez maintenant saisir le nom et le prenom des visiteurs et ajouter dans le fichier la 
date de la saisie grace a la fonction timet) (voir le chapitre 8). 

Pour que les donnees issues du formulaire soient traitees par le fichier lui-meme, vous 
devez indiquer le nom du fichier dans l'attribut action de l'element <form> ou, mieux 
encore, utiliser la variable $PHP_SELF (voir le chapitre 6). 

Pour faciliter la lecture et la recuperation des donnees ecrites dans le fichier, faites suivre 
chaque donnee d'un retour a la ligne cree par la chaine "\n", que vous concatenez 
avec chaque donnee. 

Votre script precedent ne faisait que creer un fichier devant contenir une unique valeur, 
differente pour chaque connexion mais toujours unique. La lecture ne posait done pas de 
probleme. Si vous voulez enregistrer le nom et le prenom d'un visiteur ayant rempli un 
formulaire ainsi que la date de la connexion a l'aide de la fonction timet ), il vous faut 
un moyen de separer les donnees sous forme de paquets. Ces paquets occuperont chacun 
une ligne du fichier, ce qui facilitera la lecture d'un paquet a la fois. Chaque ligne du 
fichier texte sera un enregistrement correspondant a un seul visiteur. 

Vous pouvez formater les donnees en les separant theoriquement par n'importe quel 
caractere. En pratique, il y a lieu de choisir un caractere qui ne risque pas de faire partie 
d'une donnee entree par l'utilisateur, par exemple un point-virgule que Ton ne devrait 
pas rencontrer dans un nom ou un prenom. Par securite, vous pourriez envisager d'effec- 
tuer un validation des donnees avant de les enregistrer a l'aide d'une expression reguliere 
(voir le chapitre 4) pour eliminer celles qui ne sont pas conformes a un modele stricte- 
ment alphabetique. A la fin de chaque enregistrement, vous ajoutez le caractere de retour 
a la ligne "\n", qui permet de n' avoir qu'un seul groupe de donnees par ligne du fichier. 

Ce formatage permet de surcroit une lecture plus facile du fichier en permettant la lecture 
de donnees de longueur inegale. 

La fonction d'ecriture suivante : 



fwrite($id_file,$nom. 



Sprenom 



$date 



"\n" ) 
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ecrit les chaines de caracteres contenues dans les variables $nom, Sprenom et $date asso- 
ciees a un visiteur en les separant par la chaine " ; " et en terminant chaque enregistrement 
par un saut de ligne "\n". La structure du fichier texte correspondant est conforme a celle 
illustree a la figure 11-2. Vous verrez tout l'interet de ce formatage des donnees en utili- 
sant la fonction de lecture particuliere fgetcsv( ). 

L'exemple 11-2 ci-apres utilise cette technique pour enregistrer le nom et le prenom d'un 
visiteur apres soumission d'un formulaire de saisie. La date du jour fournie par la fonc- 
tion timet ), qui retourne le timestamp correspondant a 1' instant de 1' enregistrement, est 
enregistree en meme temps que la valeur des variables precedentes. 

Le script PHP de traitement des donnees etant incorpore au meme fichier que le code 
HTML, l'attribut action de l'element <form> est designe par la variable $_SERVER ["PHP_ 
SELF"]. 

L'instruction du repere O : 

if(isset($_POST['nom']) && isset($_POST['prenom' ] ) ) 

verifie la presence des variables contenant le nom et le prenom. Si le visiteur ne complete 
pas toutes les zones de texte, un message lui rappelle les instructions (repere ©). 

L'instruction du repere © : 

if ($id_file=fopen( "noms.txt" , "a") ) 

verifie ensuite si l'ouverture du fichier a reussi. Dans le cas contraire, un message 
d'erreur s'affiche. 

Le bloc de code suivant : 



flock($id_file,2); 

fwrite($id_file,$prenom. ' 

flock($id_file,3); 

fclose($id_file); 



'.$nom." ;".$date."\n") ; 



realise successivement le verrouillage, l'ecriture des donnees formatees, le dever- 
rouillage puis la fermeture du fichier (reperes Q, 0, © et Q), comme dans l'exemple 
precedent (exemple 11-1). 

La figure 11-2 montre la structure du fichier texte noms.txt cree par le script telle que 
vous pouvez la visualiser dans le Bloc-notes de Windows. 





E» noms - Bloc -notes 


BIS 


Fichier Edition Format Affichage ? 


Jean; Engel s ; 10797283020 
Jan; Geetsen; 10797283630 
Lucie;Feire; 1079738493 
Ma ckin;Tosche; 10801 646570 





Figure 11-2 

Structure du fichier texte formate visualisee dans le Bloc-notes de Windows 
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Exemple 11-2. Saisie et enregistrement a partir d'un formulaire 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="content-type" content="text/html ; charset=iso-8859-l" /> 
<title>Les fichiers PHP </title> 
</head> 

<body style="background-color: #ffcc00;"> 
<form action="<?= $_SERVER[ ' PHP_SELF ' ] ?>" method="post" > 
<fieldset> 

<legend><b>Enregistrez vos informations personnelles </b></legend> 
<p><b> Votre nom      </b> 
<input type="text" name="nom" > <br /> 
<b> Votre prenom </b> 
<input type="text" name="prenom"> <br /> 
<input type="submit" value="Enregistrer"> 
<input type="reset" val ue="Effacer"X/p> 
</fieldset> 
</form> 
<?php 

if(isset($_POST['nom']) && isset($_POST[ 'prenom' ])) <-© 
{ 

$nom=$_POST['nom' ] ; 

$prenom=$_POST[ 'prenom' ] ; 

echo "<h2> Merci $prenom $nom de votre visite </h2> "; 

$date=time( ); 

i f ( $i d_f i 1 e=f open ( "noms . txt " , " a " ) ) <— © 



.$date."\n"); ^0 



flock($id_file,2); <-© 
fwrite($id_file,$prenom. " ; " .$nom. 
flock($id_file,3); <-0 
fclose($id_file); ^© 
} 
else { echo "Fichier inaccessible";} 



else{ echo "<h2>Completez le formulaire puis cliquez sur 'Envoi' ! </h2> ";}<—© 

?> 

</body> 

</html> 
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Figure 11-3 

Page rfe scdste d' informations 

Lecture de fichiers 

Avant de lire le contenu d'un fichier, il faut generalement l'ouvrir. Comme vous l'avez vu, 
cela s'effectue a l'aide de la fonction fopenO. Pour effectuer la lecture elle-meme, vous 
avez le choix entre plusieurs methodes, chacune etant realisable grace a une fonction 
PHP specialisee. Ces fonctions sont fgetsO, freadO, fseekO, fgetcvsO, readfileO, 
file( ) et passthruO. 

Les sections suivantes examinent les particularites respectives et le domaine d' applica- 
tion de chacune d'elles. II vous appartient de choisir celle qui convient le mieux a vos 
besoins. 



Lire une ligne a la fois 

La fonction fgets( ) a pour syntaxe : 

string fgetst resource $id_file,integer nombre_octets) 

Cette fonction lit le fichier depuis son debut et retourne une chaine de caracteres d'une 
longueur maximale egale au parametre nombre_octets. La lecture s'arrete quand ce 
nombre d' octets lu est atteint ou avant qu'il soit atteint, si le caractere "\n" est rencontre 
dans le fichier. 

Le code de l'exemple 11-3 effectue, a l'aide de la fonction fgetsO, la lecture du fichier 
noms . txt cree a l'exemple 1 1-2 et recupere les donnees de deux manieres differentes. 

La premiere partie ouvre le fichier en lecture seule (repere Q) P u i s lit une ligne du fichier 
a la fois (repere ©), affiche chaque ligne dans une cellule de tableau XHTML (repere ©) 
et ferme le fichier (repere ©). 



PHP 5 



La seconde lecture, qui permet de recuperer chaque donnee individuellement, effectue 
les memes operations et profite du formatage des donnees realise lors de l'ecriture a 
l'aide du separateur " ; " afin d'isoler chacune des donnees d'une ligne a l'aide de la fonc- 
tion explodeO. Cette derniere scinde la chaine et cree le tableau $tab contenant chacun 
des mots de la chaine (repere 0). 

Vous obtenez le prenom dans 1' element $tab[0], le nom dans $tab[l] et le timestamp dans 
$tab[2]. Vous pouvez des lors afficher chacune des donnees dans une cellule particuliere 
de tableau HTML et exploiter la valeur du timestamp pour afficher la date de connexion 
en clair a l'aide de la fonction dateO (repere ©). Vous obtenez un affichage tel que celui 
de la figure 11-4. 

Exemple 11-3. Lecture de fichier avec la fonction fgets() 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="content-type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture de fichiers avec fgetsO </title> 
</head> 
<body> 
<?php 

$file="noms.txt" ; 
//Premiere lecture 
$id_file=fopen($file,"r");// <-Q 
$1=1; 

echo "<h3>Lecture du fichier \"$file\" ligne par ligne<br /> 
*»Affichage brut de chaque ligne</h3> "; 
echo "<table border=\"l\"> \n <tbody> \n"; 
while($ligne=fgets($id_file,100) )//<-© 
{ 

echo "<tr><td>Ligne numero $i </td> <td><b>$ligne </b></td> </tr>";//<-© 
$i++; 
} 

fclose($id_file); <-© 
echo "</tbody></table> "; 
//Deuxieme lecture 
$id_file=fopen($file,"r") ; 
$1=1; 

echo "<h3>Lecture du fichier \"$file\" ligne par ligne<br /> 
** Recuperation de chaque donnee </h3> "; 
echo "<table border=\"l\"> <tbody>"; 

echo "<trXth>Numero </th> <th>prenom</th> <th>nom</th> <th>date</thX/tr>" ; 
whi 1 e( $1 i gne=f gets ($id_file, 100) ) 
{ 

$tab=explode (" ; " ,$1 igne) ; <— Q 
$jour= date("j/n/Y H:i :s" ,$tab[2] ) ; <-© 

echo "<tr><td>$i</td> <th>$tab[0]</th> <th>$tab[l]</th> <th>$jour</th> </tr>"; 
$i++; 
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fclose($id_file); 

echo "</tbody></table> 

?> 

</body> 

</html> 
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A ITidi a of brut de chaque ligne 

Ligne numcro 1 Je an; Engels; 1079728302 
Ligne numero 2 Jan;Geelsen;1079728363 
Ligne numero 3 Lucie;Feire;107973S493 

Lecture du ii elder "noms.txt" ligne par ligne 
Recuperation de chaque donnee 
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date 
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Figure 11-4 
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Lire un nombre de caracteres donne 

La fonction fread( ) a pour syntaxe : 

string f read( resource $id_file, integer nb_octets) 

Cette fonction lit egalement le fichier depuis son debut et retourne a chaque appel une 
chaine de caracteres contenant exactement le nombre de caracteres precise dans le 
second parametre, sauf si la fin du fichier est atteinte ou si le caractere "\n" est rencontre. 
Son utilisation est done adaptee a des fichiers dans lesquels vous avez prealablement 
enregistre des donnees de longueur fixe par paquets egaux. 

Pour illustrer l'usage de cette fonction, vous allez creer un script permettant d'implanter 
sur un site un systeme de vote enregistrant les choix des visiteurs effectues grace a un 
formulaire de saisie. Chaque proposition de vote pour un footballeur est faite a l'aide 
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d'un bouton radio, et tous les boutons ont la meme valeur pour l'attribut name. Cela oblige 
le visiteur a faire un choix unique, chaque clic sur un bouton desactivant le choix prece- 
dent. Le script de traitement des votes ne recoit de la sorte qu'une seule variable, quel que 
soit le vote. 

La valeur associee a chaque choix est contenue dans l'attribut value de chaque bouton 
radio, et c'est elle que le script recupere pour la stacker dans le fichier. La lecture se 
faisant par paquet d'octets de longueur fixe, les chaines contenues dans les attributs 
val ue doivent toutes avoir la meme longueur. Vous raccourcissez done les noms stockes 
pour obtenir cinq caracteres, comme pour les valeurs "anel ka" et "gourcuff " (reperes Q 
et©). 

Comme il n'est pas necessaire d'enregistrer un texte expressif associe a chaque vote, 
vous auriez pu tout aussi bien associer a chaque choix des chaines arbitrages du genre 
"aaa", "bbb", "ccc" ou encore plus simplement les chiffres "1", "2" et "3", ce que vous 
ferez dans le script suivant. 

Chaque vote est enregistre sur une ligne du fichier texte car vous ajoutez le caractere "\n" 
apres chaque enregistrement. Lors de la lecture, il vous faut done lire les donnees par 
groupe de 6 caracteres et non par groupe de 5, comme vous auriez pu le penser apres 
avoir enregistre des mots de 5 caracteres. 

Le formulaire de saisie comporte deux boutons de type submi t, le premier pour voter et le 
second pour afficher les resultats en cours de 1' ensemble des votes. 

Le script commence par tester sur quel bouton d' envoi l'utilisateur a clique (repere ©) 
puis, selon le cas, enregistre le vote dans le fichier texte "votes . txt" et affiche un message 
de remerciement (repere ©). Cette partie, destinee a 1' enregistrement des donnees, 
n'apportant rien de nouveau par rapport aux exemples precedents, nous ne detaillons pas 
son fonctionnement. 

La partie Affichage des resultats lit tout le fichier puis affiche les resultats en nombre 
de voix et en pourcentage selon l'ordre croissant. Elle commence par initialiser le 
tableau $result des resultats des votes en mettant a tous les scores (repere©). 
Si le bouton Afficher est clique (repere ©), vous controlez l'ouverture du fichier 
votes . txt (repere ©). Une boucle while lit ensuite les blocs de 6 caracteres (repere ©) et 
incremente chaque fois le score d'un des joueurs a l'aide d'une instruction switch 
(repere ©). 

Pour afficher des pourcentages, vous calculez le nombre total de votants (repere ©). 
Apres avoir cree une copie du tableau $resul t dans la variable $tri , vous la triez en ordre 
croissant en utilisant la fonction de tri arsort( ) (repere ©). 

Une boucle foreach permet alors l'affichage de l'ensemble des resultats (repere ©). 
Exemple 11-4. Script de vote en ligne 

I<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 



Les fichiers 

Chapitre 1 1 



<head> 

<meta http-equi v="content-type" content="text/html ; charset=iso-8859-l" /> 

<title>Sondage en ligne : VOTEZ F00T!</title> 

</head> 

<body style="background-color: #ffcc00;"> 

<form action="<?php echo $PHP_SELF ?>" method="post" > 

<fieldset> 

<legend><b>Votez pour votre joueur prefere! </b></legend> 

<P> 
<?php 

$joueurs=array("anel k"=>"Anel ka" , "gourc"=>"Gourcuff " , "riber"=>"Ribery") ; 
?> 

Anel ka<input type="radio" name="vote" value="anel k" /> <br /> <— O 
Gourcuff<input type="radio" name="vote" val ue="gourc" /> <br /> <— Q 
Ribery<input type="radio" name="vote" value="riber" /> <br /> 
<input type="submit" val ue="Voter" /> 

<input type="submit" val ue="Afficher les resultats" name="affiche" /> 
</p> 

</fieldset> 
</form> 

//Enregistrement 
<?php 

if(isset($_POST["vote"])) <-© 
{ 
$vote=$_POST["vote"] ; 

echo "<h2> Merci de votre vote pour " .$joueurs[$vote] ."</h2> " ; <— Q 
if (file_exists( "votes.txt") ) 
{ 
if ($id_file=fopen( "votes.txt" , "a") ) 
{ 
flock($id_file,2); 
fwrite($id_file,$vote."\n") ; 
flock($id_file,3); 
fclose($id_file) ; 
} 

else 
{ echo "Fichier inaccessible"; 



$id_file=f open ("votes.txt" ,"w") ; 
fwrite($id_file,$vote. "\n"); 
fclose($id_file) ; 



else 

{ echo "<h2>Completez le formulaire puis cliquez sur 'Voter' ! </h2> 

//Affichage des resultats 

//Initialisation du tableau des resultats 
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$result=array("Anelka"=>0,"Gourcuff"=>0,"Ribery"=>0); <— 
//Affichage des resultats 
if(isset($_POST["affiche"])) <-© 
{ 
i f ( $i d_f i 1 e=f open ( " votes . txt " , " r " ) ) <— Q 
{ 
while($ligne=fread($id_file,6) ) <— © 
{ 
switch($ligne) <— Q 
{ 

case "anelk\n": 
$result["Anelka"]++; 
break; 

case "gourc\n": 
$result["Gourcuff"]++; 
break; 

case "riber\n": 
$result["Ribery"]++; 
break; 
default: 
break; 
} 
) 
fclose($id_file); 
} 

$total= ($result["Anelka"] + Sresul t["Gourcuff"]+$resul t["Ribery"] )/100; <— flj) 
$tri=$result; 
arsort($tri); <— © 

echo "<div style=\"border-style:double\" >"; 
echo "<h3> Les resultats du vote </h3>"; 
foreach($tri as $nom=>$score) <— © 
{ 

$i++; 

echo "<h4>$i<sup>e</sup> : ", $nom," a $score voix soit ", 
^■number_format($score/$total .2) , "%</h4>" : 
} 

echo "</div>"; 
} 

?> 

<p> 

<a href="http://val idator.w3.org/check?uri=referer"Ximg 
src=" http://www.w3.org/Icons/valid-xhtml 11" 
alt="Valid XHTML 1.1" height="31" width="88" /></a> 
</p> 
</body> 
</html> 

Le resultat de ce script illustre a la figure 11-5 presente le formulaire de saisie avec le 
resultat des votes. 
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Les resultats du vote 
l e : Anelka a 9 voii soit 45.00% 
2 e : Ribery- a 7 voii soit 35.00% 
3 e : Gonrenff a 4 voix soit 20.00% 
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Figure 11-5 

Page de vote en ligne et resultats 



Lire un caractere a la fois 

PHP propose une fonction pour lire un caractere a la fois dans le fichier texte. Cette 
possibility n'a d'interet que si vous pouvez stocker les informations dans le fichier sous 
une forme codee avec des chiffres de a 9 ou encore avec des lettres de A a Z. Cela 
permet d'etendre les possibility's a 26, voire le double si vous utilisez aussi les minus- 
cules de a a z. 

La fonction PHP a utiliser est : 

string fgetct resource $id_file) 

Elle utilise comme unique parametre l'identifiant de fichier retourne par la fonction f open ( ) . 
Vous allez l'appliquer a votre script de vote precedent en modifiant le code du fichier 
XHTML pour attribuer comme valeur associee a chaque bouton radio un chiffre de 1 a 3. 

Remplacez pour cela les trois lignes de creation des boutons par le code suivant : 

IAnel ka<i nput type="radio" name="vote" value="l" /> <br /> 
Gourcuff<input type="radio" name="vote" value="2" /> <br /> 
Ribery<input type=" radio" name="vote" value="3" /> 
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Chaque vote est enregistre dans le fichier votes2 . txt par un nombre de 1 a 3 sans saut de 
ligne apres chacun d'eux. Ce fichier a la structure d'une suite de nombres entiers non 
separes par des espaces, comme l'illustre la figure 1 1-6. Si une telle structure est evidem- 
ment tres difficile a lire pour un humain, la fonction fgetc( ) le fait tres facilement a votre 
place. 
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Figure 11-6 

Fichier de donnees votes2.txt visualise dans le Bloc-notes de Windows 

La partie du script qui effectue la lecture des donnees ne differe que par l'utilisation de la 
fonction fgetc( ). Cette partie devient done : 

if ($id_file=f open ("votes2.txt", "r")) 
{ 
while($ligne=fgetc($id_file) ) 
{ 
switch($l igne) 
{ 

case "1": 

$result["Anelka "]++; 
break; 
case "2": 

$result["Gourcuff "]++; 
break; 
case "3": 

$result["Ribery "]++; 
break; 
default: 
break; 



) 

Cette technique vous permet de stacker davantage d' informations codees sous un volume 
reduit. 



Lecture d'une partie d'un fichier 

Chaque fichier possede un pointeur de lecture et d'ecriture que vous pouvez positionner 
en un point precis du fichier. 
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Lors des operations de lecture realisees jusqu'a present, le contenu du fichier est extrait a 
partir de son debut car, par defaut, le pointeur est positionne au debut du tlchier si le para- 
metre mode de la fonction fopenO vaut "r", "r+", "w" ou "w+", et en fin de fichier s'il vaut 
"a" ou "a+". 

Vous avez egalement la possibilite de faire debuter la lecture en n'importe quel point du 
fichier en appelant la fonction : 

integer fseek( resource $id_file. integer nombre_d' octets) 

Cette fonction utilise comme les autres l'identificateur de fichier $id_file et comme 
second parametre la position donnee par un entier representant le nombre d' octet par 
rapport au debut, a partir de laquelle doit commencer la lecture. Elle ne renvoie pas une 
valeur du fichier et ne fait que positionner un pointeur en un point particulier. Elle doit 
bien stir preceder l'appel de la fonction de lecture proprement dite. 

La fonction integer fseek( ) retourne la valeur booleenne TRUE si l'operation est reussie et 
la valeur -1 dans le cas contraire. Cela permet d'effectuer une verification dans le script. 

Pour illustrer ce type de lecture, vous allez reprendre l'exemple precedent et eliminer les 
dix premiers votes en faisant debuter la lecture au onzieme caractere du fichier, car 
chaque vote n'occupe plus qu'un seul caractere. II est possible a tout moment de remettre 
le pointeur au debut du fichier a l'aide de la fonction : 

| boolean rewindCresource $id_file) 

qui retourne FALSE en cas d'echec. 

Quand la lecture est en cours, la fonction suivante retourne la position du pointeur en 
nombre d'octets par rapport au debut du fichier, qui permet de savoir quel est l'enregis- 
trement lu : 

integer ftell ($id_file) 

Cette fonction retourne FALSE en cas d'erreur. 

En complement, la fonction : 

integer filesize(string "nom_fichier") 

retourne le taille totale du fichier, ce qui vous permet de lire uniquement, par exemple, 
les vingt derniers votes enregistres. 

Pour cela, il vous suffit d'inserer les lignes suivantes : 

|$taille= filesi zeCvotes2.txt") ; 
fseek($id_file,$taille-20); 

avant le debut de la boucle whi 1 e, qui effectue la lecture des donnees du fichier. 

Vous recuperez dans la variable $tai 1 1 e le nombre total d'octets du fichier puis positionnez 
le pointeur 20 octets avant la fin du fichier. Cela n'est possible que parce que chaque vote 
est enregistre sur un seul caractere. Vous avez done toujours interet a coder les enregistre- 
ments sur un seul caractere quand vous proposez un eventail de choix limite aux visiteurs. 
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Lecture de donnees formatees 

Quand le fichier a lire contient des donnees sous forme de chaines de caracteres de 
longueur irreguliere, correspondant a des entrees diverses de la part des utilisateurs, les 
methodes precedentes se revelent difficiles a mettre en oeuvre pour recuperer les donnees. 

Vous avez deja realise l'ecriture de donnees formatees en les separant a l'aide d'un carac- 
tere particulier, en 1' occurrence un point- virgule, dans le fichier noms.txt de l'exem- 
ple 11-2. Vous allez maintenant les lire d'une maniere plus elegante grace a la fonction : 

array fgetcsv( resource $id_fi1e, integer nombre_octets, string "separateur") 

Cette fonction lit dans le fichier identifie par $i d_f i 1 e au maximum le nombre de carac- 
teres precise a l'aide du deuxieme parametre. A la difference des autres fonctions de 
lecture, elle retourne directement un tableau de chaines de caracteres et non une seule 
chaine a chaque appel, comme si vous appliquiez la fonction explodeO a une chaine 
comprenant un separateur. 

Le premier element de ce tableau est la chaine comprise entre le debut du fichier et 
l'apparition du caractere de separation ou de la chaine indiquee par le troisieme parametre. 
En regie generale, vous vous limiterez pour cette chaine a un seul caractere, tel qu'il est 
utilise dans l'ecriture du fichier noms.txt. II est theoriquement envisageable de separer 
chaque donnee par la chaine "stop", par exemple, ou n'importe quelle autre chaine ne 
risquant pas de corresponds a une entree reelle d'un visiteur. En pratique, tous les tests 
effectues avec un separateur de plusieurs caracteres provoquent des problemes lors de la 
lecture. Vous vous limiterez done a un seul caractere, en l'occurrence les deux-points " : ". 

Les elements suivants du tableau de resultats sont les chaines comprises entre deux 
occurrences du separateur. La lecture de chaque ligne s'arrete, comme avec les autres 
fonctions, lors de l'apparition d'un saut de ligne "\n" dans le fichier. 

L'utilisation de la fonction fgetcsvO fournit la meilleure gestion des donnees. Vous la 
mettrez en pratique dans le script suivant, qui cree un livre d'or dans lequel chaque visiteur 
peut enregistrer son nom, ou son pseudonyme le plus souvent, son adresse e-mail, la date 
du moment precis de l'enregistrement fournie par la fonction timet ) (repere O) et le 
texte de son commentaire. 

Les valeurs transmises par le formulaire sont contenues dans les variables $_P0ST [ ' nom ' ], 
$_P0ST['mail '] et $_P0ST[ 'comment']. Le script commence par verifier que chacun des 
champs est complete puis enregistre ces donnees et la date en cours en les separant par le 
caractere " : " et en finissant chaque ligne par le caractere "\n" (repere ©). Comme dans 
les scripts precedents, une verification est faite lors du premier enregistrement pour creer 
le fichier 1 ivre.txt quand il n'existe pas (repere ©). 

La lecture est realisee si l'utilisateur clique sur le bouton "Afficher les avis", ce qui est 
detecte par le controle de l'existence de la variable $_P0ST[ ' affi che ' ] (repere ©). 

Apres ouverture du fichier (repere 0), une boucle whi 1 e lit un maximum de 200 caracte- 
res par ligne a l'aide de l'instruction suivante (repere 0) : 

while($tab=fgetcsv($id_file,200,":")) 
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et enregistre les donnees dans le tableau $tab. L'affichage se fait sous forme de tableau 
XHTML, comme l'illustre la figure 11-7. Dans ce tableau, chaque adresse e-mail est conte- 
nue dans un lien mai 1 to : , ce qui permet a un visiteur de repondre a un autre (repere ©). 

Exemple 11-5. Livre d'or utilisant des donnees formatees 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="content-type" content="text/html ; charset=iso-8859-l" /> 
<title>Le livre est d'or </title> 
</head> 

<body style="background-color: #ffcc00;"> 
<form action="<?php echo $PHP_SELF ?>" method="post" > 
<fieldset> 

<legend><b>Donnez votre avis sur PHP 5 ! </b></legend> 
<label>Nom :  </labelXinput type="text" name="nom" /> <br /> 
<label>Mail :  </l abelXinput type="text" name="mail" /> <br /> 
<label>Vos commentaires sur le site</l abelXbr /> 
<textarea name="comment" rows="4" cols="50">Ici </textarea> <br /> 
<input type="submit" val ue="Envoyer " name="envoi" /> 
<input type="submit" val ue="Afficher les avis" name="affiche" /> 
</fieldset> 
</form> 
<?php 

$date= timet);// <-© 
//ENREGISTREMENT 
if(isset($_POST['envoi '])) 
{ 
if(isset($_POST['nom']) && isset($_POST[ 'mail ' ] ) && isset($_POST['comment' ] ) ) 
{ 
echo "<h2>" ,$_P0ST[ 'nom'] , " merci de votre avis </h2> "; 
if (file_exists("l i vre.txt" ) ) 
{ 
if ($id_file=fopen ("livre.txt", "a")) 
{ 
flock($id_file,2); 

fwri te ( $i d_f i 1 e , $_P0ST[ ' nom '].":" . $_P0ST[ ' mai 1 '].":" . $date . " : " . 
*-$_P0ST[' comment ']."\n") : <-© 
flock($id_file,3); 
fclose($id_file) ; 
} 

el se 

{ echo "fichier inaccessible"; 
} 
} 

else 
{ 
$id_file=f open ("livre.txt" ,"w") ; <— © 
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fwri te( $i d_f i 1 e , $$_POST[ ' nom '].":" . $$_P0ST[ ' mai T ].":". $date .":" . 
*$$_P0ST[ 'comment ' ] . "\n" ) ; 
fclose($id_file) ; 
} 
) 
} 

//LECTURE DES DONNES 
i f ( i sset ( $_P0ST[ ' af f i che " ] ) ) ^0 
{ 
i f ( $i d_f i 1 e=f open ( " 1 i v re . txt " , " r " ) ) <— © 
{ 
echo "<table border=\"2\"> <tbody>"; 
$i=0; 

while($tab=fgetcsv($id_file,200,":") ) <-© 
{ 

$i++; 

echo "<tr> <td>n" $i : de: $tab[0] </td> <td> <a href=\"mail to:$tab[l]\" > 
*$tab[l] </a></td> <td>le: " ,date( "d/m/y" ,$tab[2] ) ," </tdX/tr>"; <-Q 
echo "<tr > <td colspan=\" 3 \">", stripslashes($tab[3] ) ,"</td> </tr> "; 
) 
fclose($id_file); 
} 

echo "</tbody></table> "; 
} 

else{ echo "<h2>Donnez votre avis puis cliquez sur 'envoyer' ! </h2> ";} 
?> 

</body> 
</html> 



Lecture de la totalite d'un fichier 

Dans les cas ou les fichiers contiennent des donnees utilisables dans une page Web a titre 
de contenu de grande longueur (articles, documentations, etc.), il est envisageable de 
creer des pages dynamiques, dont seule une partie du texte est adaptee a une circonstance 
particuliere. Vous avez alors besoin de lire la totalite d'un fichier sans avoir a analyser 
son contenu, comme vous l'avez fait pour le script de votes, et a l'envoyer directement au 
navigateur, comme le ferait une instruction echo. 

La fonction a utiliser est : 

integer readfile(string "nom_fichier" , [boolean path]) 

Cette fonction prend comme premier parametre le nom du fichier. Le second parametre 
est facultatif. S'il vaut TRUE, il indique que la recherche du fichier doit se faire dans 
le dossier courant et dans le dossier de niveau superieur s'il n'est pas trouve dans le 
premier ; s'il vaut FALSE, la recherche est limitee au dossier qui contient le script. 

La fonction retourne un entier indiquant le nombre total d'octets affiches. Contrairement a 
la plupart des fonctions de lecture, readf i 1 e( ) ne necessite pas l'appel des fonctions fopen( ) 
et fclose( ) d'ouverture et de fermeture. Cette fonction est illustree a l'exemple 11-6. 



Les fichiers 

Chapitre 1 1 



■ Le livre est d'c 
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C'est facile, pas cher et ca marche d'enfer! 



n c 2 : de: Pierre 



pierre^ blabla.com 



Be: 18/11/08 




Avec la version PHP 5. les concurrents de PHP n'ont qua bien se tenir! 



n° 3 : de: Engels 



i engels 'a eyrolles. c om 



le: 21/11/OS 



PHP 5 va apporter un renouveau certain sur le Web 



Figure 11-7 

Page du livre d' or avec l' affichage des avis 



Vous disposez d'une autre fonction, au comportement assez proche de readfileO 
puisqu'elle ne necessite pas l'ouverture explicite du fichier. II s'agit de la fonction f i 1 e( ), 
qui retourne la totalite du contenu du fichier dans un tableau indice dont chaque element 
est constitute d'une seule ligne du fichier. Sa syntaxe est la suivante : 

array file(string "nom_fichier") 

II suffit d'utiliser une boucle for ou foreach pour afficher chacune des lignes du tableau. 
Vous retrouvez done des similitudes d'emploi entre cette fonction et la fonction f getcsv( ) 
utilisee a l'exemple 11-5, a la difference pres que chaque element du tableau est ici une 
ligne entiere du fichier. Comme vous y aviez enregistre chaque donnee fournie par les 
visiteurs en utilisant comme separateur le caractere ":", dans le fichier livre.txt vous 
pouvez recuperer individuellement chaque donnee en « eclatant » la chaine lue pour 
chaque ligne a l'aide de la fonction expl ode( ) (voir le chapitre 5). Cette fonction cree un 
tableau a quatre elements a partir de ces chaines qui comportent quatre mots (le nom, 
l'adresse e-mail, la date et le commentaire), separes par des caracteres " : ". 

Pour ne pas utiliser une trop grande quantite de memoire, vous ne creez pas autant de 
variables qu'il y a de donnees totale mais reutilisez la meme apres chaque affichage. 
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En utilisant la fonction f i 1 e( ), la partie lecture des donnees de l'exemple 11-5 devient : 

if(isset($_POST["affiche"])) 
{ 
echo "<table border=\"2\"> <tbody>"; 
$i=0; 

//$tab contient toutes les lignes du fichier 
$tab=file("livre.txt B ); 
//lecture de $tab 
for($i=0;$i<count($tab);$i++) 
{ 
$ligne= explode ( " : " ,$tab[$i] ) ; 

echo "<tr> <td>de: $ligne[0] </td> <td> <a href=\"mail to:$l igne[l]\" > 
*$ligne[l] </a></td> <td>le: " ,date("d/m/y" ,$1 igne[2] ) ," </td></tr>"; 
echo "<tr > <td colspan=\" 3 \">", stripslashes($l igne[3]) ,"</td> </tr> "; 
} 

echo "</tbody></table> "; 
} 

Le resultat de la lecture est exactement celui que vous avez obtenu avec la fonction 
fgetcsvC ), comme vous pouvez le constater a la figure 1 1-7. 

Une derniere fonction permet la lecture d'un fichier dans son integralite. II s'agit de la 
fonction : 

fpassthru($id_file) 

qui, contrairement aux deux precedentes, necessite l'emploi de fopenO pour ouvrir le 
fichier mais pas de f cl ose( ) pour le fermer. La fonction ferme automatiquement le fichier, 
ce qui implique que l'identifiant de fichier obtenu avec fopen( ) est ensuite inutilisable. 

Cette fonction n'est pas adaptee a toutes les situations. Comme freadO, elle envoie la 
totalite du contenu du fichier directement vers le navigateur. L'exemple 11-6 donne une 
illustration de ces fonctions pour afficher 1' integralite d' articles documentaires sur des 
sujets divers. A chaque sujet correspond un bouton "Submit", qui provoque l'affichage de 
tout article correspondant sous trois formes differentes. 

L'exemple 11-6 propose la lecture d' articles sur des sujets interessant la conception Web. 
II est constitue d'un formulaire, dans lequel quatre boutons de type Submit permettent le 
choix de l'article affiche. Tous ces boutons ont le meme nom, de facon qu'une seule 
valeur soit transmise au script procedant a l'affichage (reperes O- 0> © et ©)• Le script 
recupere le choix dans la variable $sujet (repere 0), puis l'article demande est affiche 
successivement a l'aide des fonctions readfileO (repere©), fpassthruO (repere©) et 
fileO (repere @). 



Les fonctions freadQ et fpassthruO 

A la figure 11-8, les fonctions f read( ) et f passthru( ) affichent le contenu du fichier texte directement sur 
la sortie standard, sans tenir compte des retours a la ligne ni des espaces presents dans le fichier texte. Cela 
cree une presentation brute du texte alors que la fonction f i 1 e ( ) qui recupere le texte ligne par ligne respecte 
tous les sauts de ligne tels qu'ils figurent dans le fichier d'origine, ce qui est beaucoup plus presentable. 
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Exemple 11-6. Utilisation des fonctions readfilef), fpassthruQ et file() pour 
I'affichage d'articles 

<!D0CTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 

"http://www.w3.org/TR/html4/strict.dtd"> 

<html> 

<head> 

<meta http-equiv="content-type" content= 

"text/html ; charset=iso-8859-l"> 

<title>Choix d'articles </title> 

</head> 

<body style="background-color: #ffcc00;"> 

<form action="<?php echo $_SERVER[ 'PHP_SELF' ] ?>" method="post" > 

<fieldset> 

<legend><b>Choisissez votre sujet! </b></legend> 

<input type="submit" name="sujet" value="html" /> <— O 

<input type="submit" name="sujet" value="javascript" /> <— Q 

<input type="submit" name="sujet" value="php" /> <— Q 

<input type="submit" name="sujet" value="asp" /> <— © 
</fieldset> 
</form> 

<?php 

//AFFICHAGE 

if(isset($_POST['sujet'])) 

{ 

$sujet=$_POST[' sujet']; <— © 

echo "<h2>Voici 1 'article sur " ,strtoupper($sujet) ,"</h2> "; 

//Lecture du fichier avec readfileO 
//••it******************************************************* 

echo "<div style=\" background-color:#FFCCFF ; border-width:3px ; 
*»border-style:groove; \" >"; 
echo " <h4>LECTURE avec readfile( X/h4>" ; 
readfile($sujet.".txt",TRUE); <— © 
echo "</div>"; 
//it********************************************************* 

//Lecture du fichier avec fpassthruO 
//************************************•********************* 

echo "<div style=\" background-color:#FFAACC ; border-width:3px ; 

*»border-style:groove; \" >"; 

echo " <h4>LECTURE avec fpassthrut X/h4>" ; 

$id_file=fopen($sujet.".txt" ,"r") ; 

fpassthru($id_file); <— Q 

echo "</div>"; 

//Lecture du fichier avec fileO 
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echo "<div style=\" background-col or:#00AAFF ; border-width:3px 

*»border-style:groove; \" >"; 

echo " <h4>LECTURE avec file(X/h4>"; 

$tab = file($sujet.".txt",l); <-© 

for($i=0;$i< count($tab); $i++) 

{ 
echo $tab[$i],"<br>"; 

} 

echo "</div>"; 
} 

?> 

</body> 
</html> 



Dl Choix d'art fries - Microsoft Internet Explorer 
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Choisissez votre sujet! 
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LECTUEE avec readffleO 

Lc HTML Langage de balls age issu du SGML H comprend de nombrcux elements . Les elements ayant 
■un contenu ont une bake d'ouverture et une bake de fermeture. 



LECTUEE avec fpassthruO 
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ayant 




LECTUEE avee file 
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Langage de balisage issu du SGML 

II comprend de nombreux elements 

Les elements ayant un contenu ont une bake d'ouverture et une bake de fermeture. 
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£ Internet 



Figure 11-8 

Lecture d 'articles entiers a Vaide desfonctions freadQ, fpassthru() et file(). 
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Modifications de fichiers 

II est possible d'intervenir sur les fichiers presents sur le serveur en effectuant des copies, 
en les renommant ou en les supprimant. 

Copier un fichier 

II est possible d'effectuer une sauvegarde reguliere de l'etat d'un fichier a un moment 
donne en creant une copie sous un autre nom ou avec une extension differente afin de 
recuperer l'ensemble des donnees en cas de probleme ayant atteint l'integrite du fichier. 

Cette operation se realise a l'aide de la fonction copy( ), dont la syntaxe est la suivante : 

boolean copy(string "nom_fichier" .string "nom_copie") 

Cette fonction retourne la valeur booleenne TRUE si la copie est realisee et FALSE en cas de 
probleme d'ecriture. 

Dans le code suivant, vous realisez une copie du fichier votes.txt sous le nom 
votes. txt.bak (mais vous pourriez aussi bien le faire sous un nom quelconque) si le 
script est execute chaque jour a neuf heures du matin : 

<?php 

$date= getdate( ) ; 

if($date["hours"]==9 && $date["minutes"]==0) 

{ 

$result= (copy( "votes.txt" , "votes. bak") )? "Copie realisee": "Erreur de copie" ; 

echo $result; 
} 
?> 

Cette partie de code pourrait etre ajoutee au script de vote pour effectuer la sauvegarde 
journaliere ou constituer un script independant. 

Si le site a un trafic important, vous pouvez remplacer la condition de l'instruction i f par 
l'expression : 

if($date["hours"]==9 && $date["minutes"]==0 && $date["seconds"]==0) 

De la sorte, la sauvegarde n'a pas lieu a chaque connexion pendant tout la minute concer- 
ned mais seulement pendant une seconde. Evidemment, si le site recoit en moyenne plus 
d'une connexion par seconde (soit 86 400 par jour !), il faut faire appel a la fonction 
mi crotime( ) pour ne realiser qu'une seule sauvegarde a une microseconde precise. 

Renommer un fichier 

Dans le meme ordre d'idee que la fonction copy ( ), la fonction rename ( ) permet de chan- 
ger le nom d'un fichier existant. Comme avec 1' operation Renommer de l'Explorateur 
Windows, le fichier originel n'existe plus sous son nom initial, a la difference de la fonc- 
tion precedente. Si ce nom est utilise dans le code d'un script, il faut bien reflechir avant 
d'y avoir recours, car il faut en modifier toutes les occurrences. 
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Lors de l'appel de rename( ), le fichier concerne doit exister dans le repertoire du script et 
ne doit pas etre ouvert a ce moment precis, ce qui n'est jamais garanti s'il est utilise dans 
le code d'un script susceptible d'etre utilise en ligne. Le nouveau nom du fichier ne doit 
pas correspondre a un fichier existant dans le repertoire, faute de quoi cela provoque une 
erreur et 1' arret du script. 

II est recommande de reserver l'usage de cette fonction aux cas de telechargement de 
fichier du client vers le serveur, non sans s' assurer qu'aucun fichier du meme nom 
n'existe sur le serveur dans le meme repertoire. 

La syntaxe de la fonction rename ( ) est la suivante : 

boolean rename(string "nom_actuel " .string "nom_futur") 

Elle retourne TRUE si l'operation est effectuee et FALSE dans le cas contraire. 



Effacer un fichier 

Pour supprimer definitivement un fichier present dans le meme repertoire que le script 
qui effectue l'operation, il faut appeler la fonction unl ink( ), avec comme unique parame- 
tre le nom du fichier a supprimer contenu dans une chaine de caracteres. La fonction 
retourne TRUE ou FALSE selon que la suppression est effectuee ou non. 

Avant de realiser cette suppression, vous devez vous assurer que le fichier existe a l'aide 
de la fonction f i 1 e„exi sts ( ) (voir la section suivante), faute de quoi une erreur d'execution 
est produite. 

Le code suivant : 

if (file_exi sts ("votes. bak")) 

{$result= (unl inkC'votes.bak" ) )? "Suppression realisee" : "Echec de 

*»la suppression";} 

else 

{echo "Le fichier n'existe pas dans ce repertoire! <br>";} 

supprime le fichier votes. bak apres avoir verifie qu'il existe et affiche un message de 
confirmation si l'operation est reussie. 

Informations sur les fichiers 

Vous pouvez egalement obtenir des informations utiles sur les fichiers presents sur le 
serveur, comme la verification de leur presence, leur taille, leur type, leur date de creation 
ou de modification. 

Existence d'un fichier 

Pour eviter certaines erreurs qui arretent irremediablement les scripts, il est souvent 
indispensable de verifier qu'un fichier existe reellement avant d'effectuer des operations 
d'ajout, de lecture ou de suppression. 
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La fonction suivante : 

boolean file_exists( string "nom_fichier") 

retourne une valeur booleenne TRUE ou FALSE selon que le fichier existe ou non dans le 
dossier du script qui l'appelle. 

Vous avez deja utilise cette fonction sans la connaitre en conjonction avec la fonction 



touch ( ) pour creer un fichier, s'il n'existait pas encore. Vous aviez alors le code suivant : 

I if ( lfile_existsCmonfich.txt" ) ) { 
touch C "monfich.txt" , timet )) ; } 

qui creait le fichier monf i ch . txt uniquement apres avoir verifie qu'il n'existait pas deja. 



Taille des fichiers 

Vous pouvez verifier la taille d'un fichier au moyen de la fonction suivante : 

integer filesize(resource $id_file) 

qui retourne un entier representant le nombre d'octets du fichier et en cas d'erreur. Vous 
obtenez egalement la valeur si le fichier est vide, par exemple s'il vient d'etre cree a 
l'aide de la fonction touchO. 

Associee a la fonction fseekO, que vous avez deja utilisee, la fonction integer files ize() 
permet de lire une partie seulement du fichier, qui sera exprimee en pourcentage ou frac- 
tion de sa taille totale. 

Pour eliminer 90 p. 100 des donnees du debut du fichier, quelle que soit sa taille, et en 
lire les 10 p. 100 restants, vous auriez, par exemple : 

fseek($id_file, floor(0.9 *filesize ($id_file) ) ) 

Le resultat de l'operation 0.9*filesize($id_file) risquant d'etre un decimal, vous utili- 
sez la fonction f 1 oor( ) pour vous assurer que le parametre est entier. 

Informations diverses 

Avant d'effectuer des operations sur un fichier, il est possible de verifier s'il s'agit bien 
d'un fichier et non d'un repertoire, par exemple, ou encore de savoir quel type d' opera- 
tion vous pouvez realiser sur ce fichier. 

Pour verifier qu'il s'agit d'un fichier, vous avez a votre disposition la fonction suivante : 

boolean i s_f i 1 e( string nom_fichier) 

qui retourne la valeur booleenne TRUE pour le fichier ouvert identifie par $i d„f i 1 e et FALSE 
s'il ne s'agit pas d'un fichier. 

Vous pouvez egalement verifier si le fichier identifie est disponible en lecture ou en ecri- 
ture a l'aide des fonctions suivantes : 

boolean is_readable( string nom_fichier ) 
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qui retourne TRUE si le fichier est lisible et FALSE dans le cas contraire, et : 

boolean is_writable(string nom_fichier ) 

qui retourne TRUE si le fichier est disponible en ecriture et FALSE dans le cas contraire. 

Vous pouvez aussi verifier si le fichier provient d'un telechargement avec la methode 
POST a l'aide de la fonction suivante : 

boolean is_uploaded_file( string nom_fichier) 

qui retourne TRUE si c'est le cas et FALSE dans le cas contraire. Cette fonction est utilisee 
apres le transfert de fichier du poste client vers le serveur. 

Pour savoir si vous avez affaire a un fichier ou a un repertoire, il vous faut recourir a la 
fonction f 1 1 etypeO, dont la syntaxe est la suivante : 

string filetype(string "nom_fichier") 

Cette fonction retourne la chaine "f 1 1 e" si le parametre est un fichier et "di r" si c'est un 
repertoire. 

Informations de date 

Pour savoir si un script a accede a un fichier ou s'il a ete modifie depuis une date donnee, 
il existe plusieurs fonctions donnant les informations de date. Comme ces fonctions ne 
donnent pas une date en clair mais retournent un timestamp UNIX illisible pour le 
commun des mortels, il faut faire appel aux fonctions de date (voir le chapitre 8) pour 
afficher un resultat en clair. 

C'est ce que realise l'exemple ci-dessous en utilisant la fonction date( ). 

Les fonctions a votre disposition sont les suivantes : 

• integer f ileatime(string "nom_fichier"), qui retourne le timestamp de la date du 
dernier acces au fichier dont le nom est donne dans la chaine de caracteres passee en 
parametre. 

• integer fi lemtime(string "nom_fichier"), qui retourne le timestamp de la derniere 
modification du fichier dont le nom est donne dans la chaine de caracteres passee en 
parametre. 

• integer fi lectime(string "nom_fichier"), qui retourne le timestamp de la derniere 
modification des permissions du fichier dont le nom est donne dans la chaine de carac- 
teres passee en parametre. 

Dans l'exemple 11-7, cette date est differente de celle de la derniere modification. 

Exemple 11-7. Informations de date sur les fichiers 

I<?ph P 
$file="votes.txt" ; 
$datel= fileatime($file); 
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echo "Le dernier acces au fichier $file date de : 

* " ,date( "d/m/Y H : i : s" , $datel ) , "<br>" ; 

$date2= filemtime($file) ; 

echo "La derniere modification du fichier $file date de : 

*",date( "d/m/Y H:i :s" ,$date2) ,"<br>" ; 

$date3= filectime($file) ; 

echo "La derniere modification des permissions du fichier $file est : 

*",date( "d/m/Y H:1 :s" ,$date3) ,"<br>" ; 

?> 



Le resultat du script est le suivant 



Le dernier acces au fichier votes.txt date de : 30/10/2008 21:33:45 
La derniere modification du fichier votes.txt date de : 30/10/2008 21:33:45 
La derniere modification des permissions du fichier votes.txt est : 
27/10/2008 20:09:04 

Chemin d'acces a un fichier 

Vous pouvez recuperer le chemin d'acces complet a un fichier en connaissant simple - 
ment son nom. Cela permet d'y avoir acces en lecture, par exemple, sans etre stir qu'il se 
trouve dans le meme dossier que le script qui l'utilise. 

Pour cela, vous utilisez la fonction suivante, accessible uniquement depuis PHP 4 : 

string real path(string "nom_fichier") 
qui retourne le chemin complet dans une chaine de caracteres. 
Par exemple : 

echo real path ("fichiers7.php") ; 
affiche le resultat suivant : 

c:\program files\wampserver\www\php5\cllfichiers\fichiers7.php 

A 1' inverse, vous pouvez extraire uniquement le nom d'un fichier en indiquant le chemin 
d'acces comme parametre de la fonction : 

string basename(string "chemin_d'acces" ) 
Le chemin d'acces precise peut etre partiel, comme dans le code suivant : 

echo basenameC . /php5/l istingll.7.php") 
ou une adresse URL complete, comme ci-dessous : 

basenameC "http://www.monsite.org/php5/! istingll.7.php") 
Les deux possibilites retournent la chaine : "1 i sti ngll .7 . php". 
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Memo des fonctions 



boolean copytstring nom_init, string nom_fin) 

Cree une copie du fichier nom_init sous le nom nom_fin et retourne TRUE si I'operation est reussie. 

boolean fclose(resource $id_file) 

Ferme le fichier identifie par $ i d_f i 1 e. 

boolean foef (resource $id_file) 

Retourne TRUE si le pointeur atteint la fin du fichier. 

string fgetc(resource $id_file) 

Retourne un seul caractere du fichier identifie par $i d_f 1 1 e et pointe sur le caractere suivant. 

array fgetcsv(resource $id_file, int nb, string delim) 

Retourne tous les elements de la ligne en cours du fichier identifie par $i d_f i 1 e avec un nombre maximal de caracteres. 
Les elements du fichier sont separes par le caractere precise par del im (la virgule par defaut), chacun etant un element 
du tableau retourne. 

string fgets(resource $id_file, int nb) 

Retourne toute la ligne en cours du fichier identifie par $id_file avecun nombre maximal de nb caracteres. 

string fgetss(resource $id_file, int long) 

Effectue la meme operation que la fonction f gets ( ) en eliminant de la chaine retournee les balises HTML qui s'y trouvent. 

boolean file_exists(string nom_fichier) 

Retourne TRUE si le fichier existe et FALSE dans le cas contraire. 

array file(string nom_fichier , int chemin) 

Retourne toutes les lignes du fichier dans les elements d'un tableau. 

int fileatime(string nom_fichier) 

Retourne la date du dernier acces au fichier. 

int filectime(string nom_fichier) 

Retourne la date de la derniere modification des permissions du fichier. 

int filemtime(string nom_fichier) 

Retourne la date de la derniere modification du fichier. 

int files ize( string nom_fichier) 

Retourne la taille du fichier en octets. 

string filetype (string nom_fichier) 

Retourne "f i 1 e" s'il s'agit d'un fichier et "di r" si c'est un repertoire. 

boolean flock(resource $id_file, int mode) 

Verrouille/deverrouille le fichier identifie par $id_file en fonction de lavaleur de laconstante mode. Le fichier doit avoir 

ete ouvert. Les valeur de mode sont les suivantes : 

L0CK_SH (ou 1) pourverrouilleren lecture seule par tous ; 

L0CK_EX (ou 2 ) pour verrouiller en lecture et en ecriture pour les autres utilisateurs ; 

LOCKJJN (ou 3) pour deverrouiller le fichier. 
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resource fopent string nom_fichier, string mode, int chemin) 

Ouvre le fichier dont vous precisez le nom et le mode d'acces choisi parmi les valeurs suivantes : 

"r" : acces en lecture seule, pointeur au debut du fichier. 

"r+" : acces en lecture et ecriture, pointeur au debut du fichier. 

"w" : acces en ecriture seule, pointeur au debut du fichier. Efface le contenu du fichier et le cree s'il n'existe pas. 

"w+" : acces en lecture et ecriture, pointeur au debut du fichier. Efface le contenu du fichier et le cree s'il n'existe pas. 

"a" : acces en lecture seule, pointeur en fin de fichier. Cree le fichier s'il n'existe pas. 

"a+" : acces en lecture et ecriture, pointeur en fin de fichier. Cree le fichier s'il n'existe pas. 

La fonction retourne un identifiant de fichier qui est utilise comme parametre par un grand nombre de fonctions de lecture/ 

ecriture. 

Le parametre chemi n permet d'elargir la recherche du fichier aux sous-dossiers s'il vaut 1 . 

int fpassthru(resource $id_file) 

Lit le contenu du fichier situe apres le pointeur et envoie le contenu vers la sortie standard. 

string fread( resource $id_file, int nb) 

Litun nombre nb de caracteres dans le fichier identifie par $id_file. 

int fseek(resource $id_file, int nb) 

Deplace le pointeur de fichier a la position nb. 

int ftell (resource $id_file) 

Retourne la position en cours du pointeur de fichier. 

int fwritetresource $id_file, string texte, int nb) 

Ecrit le nombre maximal nb de caracteres de la chaine texte dans le fichier identifie. 

boolean is_file(string nom_fichier) 

Retourne TRUE si le fichier existe et FALSE dans le cas contraire. 

boolean is_readable(string nom_fichier) 

Retourne TRUE si le fichier est accessible en lecture et FALSE dans le cas contraire. 

boolean is_uploaded_file(string nom_fichier) 



Retourne TRUE si le fichier provient d'un telechargement par la methode POST et FALSE dans le cas contraire. 

boolean is_writable(string nom_fichier) 

Retourne TRUE si le fichier est accessible en ecriture et FALSE dans le cas contraire. 

int readfiletstring nom_fichier, boolean chemin) 

Lit la totalite du fichier et I'envoie vers la sortie standard. 

string realpathtstring nom_fichier) 

Retourne le chemin d'acces complet du fichier. 

boolean rename(string nom_ancien, string nom_nouveau) 

Renomme le fichier nom_ancien en nom_nouveau et retourne TRUE si I'operation s'est bien executee. 

boolean rewind(resource $id_file) 

Replace le pointeur de fichier au debut. 
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resource tmpfilet ) 

Cree un fichier temporaire qui sera efface en fin de connexion. 

boolean touch(string nom_fichier, int nouv_date [,int ex_date]) 

Modifie la date de derniere modification du fichier et retourne TRUE si I'operation est reussie. Cree le fichier s'il n'existe pas 
encore. 

boolean unl ink(string nom_fichier) 

Efface le fichier dont le nom est donne. 



Exercices 



Exercice 1 

Creez un fichier pour enregistrer la date de chaque connexion a votre site. Procedez 
ensuite a la lecture des donnees, puis calculez des statistiques sur ces dates. 

Exercice 2 

Creez un fichier texte pour enregistrer le code du navigateur client sous forme d'enregis- 
trements de longueur fixe (du type "E6" pour Internet Explorer 6) suivis d'un separateur 
fixe. II est possible d'utiliser la variable $_SERVER['HTTP_USER_AGENT'] pour identifier le 
navigateur client. Apres lecture du fichier, realisez des statistiques sur ces donnees. 

Exercice 3 

En vous inspirant de l'exemple 11-5, creez un livre d'or qui n'affiche que les cinq 
derniers avis donnes par les visiteurs du site. 

Exercice 4 

Creez une loterie en ligne en enregistrant le numero gagnant dans un fichier texte. Le 
visiteur saisit sa proposition dans un formulaire, et la reponse est affichee apres compa- 
raison avec la solution. 

Exercice 5 

Creez un questionnaire en ligne dont les questions et les reponses sont contenues dans 
deux fichiers separes. Au demarrage, lisez le fichier des questions et affichez-les dans un 
formulaire, chacune etant suivie d'une zone de saisie de texte pour la reponse ou de 
boutons radio pour des reponses par oui ou par non. Apres envoi du formulaire complet, 
verifiez chacune des reponses, et affichez le score. 
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Cookies, sessions et e-mails 



Ce chapitre aborde les differentes methodes qui permettent de conserver des informa- 
tions pour ameliorer le service rendu par un site. II peut s'agir de conserver des choix fait 
par un visiteur entre deux visites pour adapter le contenu de la page d'accueil aux besoins 
de ce dernier. C'est ce que permettent les cookies. II est en outre possible de conserver 
des informations saisies dans une page et de les rendre accessibles a toutes les autres 
pages d'un meme site. Le mecanisme de session autorise ce type d'action, qui est a la 
base de la gestion de panier utilisee sur tous les sites de commerce en ligne. 

Toujours dans le but d' ameliorer le service rendu aux visiteurs ou aux clients d'un site, la 
fin du chapitre traite de l'envoi d'e-mails a partir du serveur du site vers le poste client ou 
tout autre destinataire, comme le font, par exemple, les sites de vente en ligne pour 
envoy er des confirmations de commande. 



Les cookies 



Les cookies sont de petits fichiers qui peuvent etre ecrits par un script PHP ou par 
d'autres langages, tel JavaScript, sur l'ordinateur du visiteur. A l'exception du piratage, 
c'est le seul cas oil un site peut intervenir sur le disque dur d'un utilisateur. 

Lors de sa creation par Netscape, cette possibilite a effraye plus d'un internaute, bien 
qu'elle ne presentait pas de danger reel. Chaque utilisateur garde de surcroit la possibilite 
de desactiver l'ecriture des cookies en parametrant son navigateur, mais certains services 
en ligne ne fonctionnent que si les cookies sont actives sur le poste client. II peut aussi les 
effacer a sa guise puisqu'ils se trouvent sur son ordinateur. 

Par defaut, Internet Explorer ou Firefox ecrivent les cookies sans autorisation de 1' utilisa- 
teur, tandis que Netscape (plus guere utilise il est vrai) demandait 1' accord du visiteur 
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pour chaque cookie a ecrire. Vous n'avez done jamais la certitude de pouvoir ecrire vos 
cookies pour chaque visiteur. 

Les cookies font l'objet de limites d'emploi. Un site donne ne peut ecrire que 20 cookies 
sur un meme poste client. Chacun d'eux ne doit pas depasser 4 Ko, ce qui empeche le 
stockage d'information de taille importante. Sauf specification contraire, un cookie n'est 
accessible que par le site qui Pa ecrit. L'utilisation des cookies est done generalement 
limitee au stockage d'information de petite taille, comme le nom, le code d'acces, 
Padresse ou les preferences de Putilisateur. L'usage courant est de stacker les coordon- 
nees qu'un visiteur a saisies dans un formulaire et de les lire lors d'une prochaine 
connexion pour remplir automatiquement le meme formulaire, permettant ainsi aux visi- 
teurs de gagner du temps. Les cookies sont aussi employes par le mecanisme de session, 
que nous allons aborder par la suite. II va de soi que, de par leur mode de stockage, les 
cookies ne sont pas recuperables si Putilisateur se reconnecte a partir d'un poste diffe- 
rent, contrairement a ce qu'il est possible de faire si les informations sont inscrites dans 
une base de donnees. 



Ecriture des cookies 

Pour ecrire un cookie, comme pour envoy er des en-tetes au moyen de la fonction 
headerO, il est imperatif qu'aucun contenu XHTML n'ait ete envoye au poste client 
avant Pecriture du cookie. Autrement dit, aucune instruction PHP d'affichage, ne serait- 
ce que pour afficher un seul caractere, ne doit figurer dans le script avant la fonction qui 
va creer le cookie. 

Pour ecrire un cookie, vous utilisez la fonction setcookieO, dont la syntaxe est la 
suivante : 
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boolean setcookietstring nom_cookie, [string valeur, integer datefin, 
string chemin, string domaine, integer securite] ) 



Les parametres de la fonction setcookiet ) sont les suivants : 

• nom_cooki e est une chaine definissant le nom du cookie. Ce nom obeissant aux memes 
regies de nommage que les variables, il faut eviter les caracteres speciaux. Ce nom sert 
a identifier le cookie pour les operations de lecture de leur contenu. 

• valeur contient la valeur associee au cookie. II s'agit d'une chaine de caracteres, meme 
pour un nombre. II y a done lieu d'effectuer au besoin un transtypage (voir le chapi- 
tre 2) pour effectuer des calculs avec cette valeur. 

• datefin est un entier qui permet de stacker un timestamp UNIX exprime en seconde 
(voir le chapitre 8) definissant la date a partir de laquelle le cookie n'est plus utilisable. 
Si ce parametre est omis, le cookie n'est valable que pendant le temps de connexion du 
visiteur sur le site. Pour definir cette date, vous utilisez le plus souvent la fonction 
timet ), qui donne le timestamp en cours, auquel vous ajoutez la duree desiree par un 
nombre de seconde. Pour une duree de validite de vingt-quatre heures, par exemple, 
vous ecrivez timet ) +86400. 
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• chemin definit dans une chaine le chemin d'acces aux dossiers qui contiennent les 
scripts autorises a acceder au cookie. Les scripts contenus dans les sous-dossiers 
eventuels de ce dossier ont egalement acces au cookie. Si la valeur est /, le cookie 
est lisiblesurl' ensemble dudomaine domaine. Si la valeur est /repertoire/, le cookie est 
uniquement lisible dans le repertoire /repertoire/ ainsi que tous ses sous-repertoires 
(/repertoire/sousrep/ par exemple) du domaine domaine. La valeur par defaut est le 
repertoire qui contient le script ay ant cree le cookie. 

• domaine definit le nom entier du domaine a partir duquel vous pouvez acceder au 
cookie. Vous ecrivez, par exemple, www.mondomaine.com, et non mondomaine.com seule- 
ment. Lorsque ce nom de domaine est le meme que celui qui a cree le cookie, ce qui 
est le cas le plus frequent, vous pouvez omettre ce parametre. 

• securite est une valeur de type boolean qui vaut TRUE (ou la valeur 1) si le cookie 
doit etre transmis par une connexion securisee (avec une adresse du type https:// 
www.mondomaine.com) et FALSE (ou la valeur 0) dans le cas contraire, qui est la valeur par 
defaut. 

La fonction setcookieO renvoie une valeur booleenne TRUE qui permet de controler si 
l'ecriture du cookie a eu lieu et FALSE en cas de probleme (si le navigateur client refuse les 
cookies, par exemple). 

L'exemple 12-1 ecrit plusieurs cookies en utilisant les differents parametres possibles. 
Exemple 12-1. Ecriture de cookies avec differents parametres 

<?php 

//cookie valable uniquement pour la session 

setcookieCprenom" ,"Jan") ; <— Q 

//cookie valable 24 heures 

setcookieC"nom","Geelsen",time( )+86400) ; <— © 

//Ce cookie utilise tous les parametres 

setcookie("CB","5612 1234 5678 1234" ,time( )+86400,"/cl ient/paiement/" , 

^"www.funxhtml .com" .TRUE) ; <— © 

?> 

Le premier appel de setcookieO ne definit que le nom et la valeur du cookie. Ce dernier 
n'etant valable que pendant la duree de la session, cette valeur n'est recuperable que pour 
une autre page du meme site et non pour une prochaine connexion (repere Q '- Le 
deuxieme appel cree un cookie valable vingt-quatre heures, soit 86 400 secondes 
(repere ©). Le troisieme appel cree un cookie utilisant tous les parametres possibles 
(repere ©). 

Pour effacer le contenu d'un cookie, il suffit d'utiliser la fonction setcookieO en n'utili- 
sant que le parametre nom_cooki e sans lui affecter de valeur. 

La fonction suivante : 

setcookieC'nom") 

efface la valeur precedente donnee au cookie nomme "nom". 
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Pour faire disparaitre un cookie, vous devez definir une date de validite anterieure a la 
date actuelle en conservant la valeur utilisee lors de sa definition. 

Le code suivant : 

setcookie("cb","5612 1234 5678 1234" ,time( )-3600) 

rend le cookie inaccessible mais seulement lors du rechargement de la page qui contient 
ce code. 

Vous pouvez ecrire plusieurs valeurs sous un meme nom de cookie en utilisant la nota- 
tion a crochets des tableaux. 

Le code suivant : 

Isetcookie( "client[prenom]" , "Jan" , timet )+3600) ; 
setcookie( "client [nom]" , "Geelsen" , timet )+3600) ; 
setcookiet "client[vil le]" ."Paris" , timet )+3600) ; 

enregistre un cookie nomme "client" contenant trois valeurs utilisables pendant une 
heure. 



Ecriture des cles 

Dans la definition des cookies, les cles des tableaux 
ment a I'usage habituel dans les tableaux. 


ne sont pas delimitees par des guillemets, 


contraire- 



Vous pouvez ecrire des cookies a l'aide de boucles a partir des elements d'un tableau. 
L'exemple 12-2 suivant ecrit le cookie "client2", valable deux heures, contenant trois 
valeurs en provenance du tableau $tabcook. 

Exemple 12-2. Ecriture de cookies a partir d'un tableau 

<?php 

$tabcook = array("prenom"=>"Paul " , "nom"=>"Char" ,"vil le"=>"Marseil le" ) ; 

foreach($tabcook as $cle=>$valeur) 

{ 

setcookie("client2[$cle]",$valeur,time()+7200); 
} 
?> 

Lecture des cookies 

Les donnees stockees dans les cookies ne sont recuperables dans la page qui les a crees 
que lors d'un rechargement de cette page. Les autres pages du site ont un acces immediat 
aux cookies des leur chargement. Cela procure un moyen de passage d'information d'une 
page a 1' autre, meme s'il y en a de plus commodes. 

II existe deux manieres de recuperer la ou les valeurs d'un cookie, dans une variable de 
meme nom que celui attribue au cookie ou dans le tableau associatif superglobal $_C00KI E. 
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Dans le cas ou la variable a le meme nom que le cookie, cette variable peut etre scalaire 
ou un tableau, selon le moyen utilise pour creer le cookie. Cette possibilite n'est toutefois 
plus valable depuis la version 4.1 de PHP, a moins d'activer la directive regi ster_gl obal s 
du fichier php . i n1, ce qui n'est plus le cas par defaut. En tout etat de cause, cette methode, 
consideree comme obsolete, est appelee a disparaitre. 

Avec le tableau associatif superglobal $_C00KIE, vous utilisez comme cle de l'element 
recherche le nom du cookie. Ce tableau n'etant disponible que depuis la version 4.1 
de PHP, il faut utiliser pour les versions anterieures le tableau $HTTP_COOKIE_VARS. La 
nouvelle methode est desormais recommandee. C'est done celle que vous utiliserez 
exclusivement dans la suite du chapitre. 

Dans le cookie simple suivant : 

setcookieCnom" , "Geelsen" , timet )+1000) 

vous recuperez l'information dans la variable $_C00KIE["nom"]. 

Pour le cookie sous forme de tableau suivant : 

<?php 

setcookiet "achat [premier]" , "1 i vre" ,time( )+3600) ; 

setcookiet" achat [deuxi erne]" , "CD" , timet )+3600) ; 

setcookie("achat[troisieme]" , "video" .timet J+3600) ; 

?> 

vous lisez toutes les donnees dans le tableau $_C00KIE["achat"]. II s'agit d'un tableau a 
deux dimensions, que vous pouvez parcourir a l'aide d'une boucle foreach : 

foreach($_COOKIE["achat"] as $cle=>$valeur) 
{ 

echo "Le cookie nomme: $cle contient la valeur : $valeur <br />"; 
} 

Apres avoir recharge la page dans le navigateur, vous obtenez l'affichage suivant : 



Le 


cookie nomme: 


premier contient la valeur : 


1 i vre 


Le 


cookie nomme: 


deuxieme contient la valeur : 


CD 


Le 


cookie nomme: 


troisieme contient la valeur 


: video 



Vous pouvez aussi acceder individuellement a chaque valeur. 
Pour recuperer la valeur "1 i vre", par exemple, vous ecrivez : 

$_C00KIE["achat"][ "premier"] 

Exemple de page avec cookies 

L'exemple 12-3 realise un sondage en ligne, dans lequel un seul vote est autorise. Pour 
controler que personne ne triche, vous ecrivez deux cookies, le premier pour verifier 
qu'un vote a eu lieu et le second pour enregistrer le vote. La duree de validite des cookies 
est celle du sondage, exprimee en secondes (un jour = 86 400 secondes). 
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Dans le code de l'exemple, la duree de vie des cookies est fixee a 60 secondes, ce qui 
n'est guere realiste mais tout a fait intentionnel. Cela vous permet de tester que vous 
pouvez enregistrer un nouveau vote apres ce delai. Dans la pratique, la duree devrait etre 
celle choisie pour le sondage. 

Lorsque l'utilisateur valide le formulaire, le script commence par controler l'existence 
d'un cookie indiquant s'il existe deja un vote, ici le cookie "votant" (repere ©). et la 
valeur de ce vote, ici le cookie "vote" (repere ©). Si un vote est deja enregistre, une boite 
d'alerte JavaScript affiche un message indiquant qu'il est impossible de voter deux fois 
(repere ©) et rappelle le vote precedent. 

S'il a vote, une boite d'alerte JavaScript affiche la valeur du premier vote. Dans le cas 
contraire, les deux cookies sont enregistres, puis une boite d'alerte de remerciement 
s'affiche (voir la figure 12-1). Dans la realite, chaque vote doit evidement etre enregistre 
sur le serveur, dans un fichier texte, par exemple, de facon a pouvoir afficher les resultats 
du vote (voir le chapitre 11 pour realiser cet enregistrement), ou dans une base de 
donnees (voir les chapitres 14 a 18). 

Le script est decoupe en plusieurs morceaux, delimites par les balises habituelles <?php et 
?>. Entre ces morceaux de scripts sont incorpores les elements XHTML destines a affi- 
cher les boites d'alertes. 

La suite du fichier est le code XHTML creant l'interface visible du sondage, constituee 
de boutons radio portant tous le meme nom, ce qui les rend exclusifs et n'autorise qu'un 
seul choix. 



Exemple 12-3. Sondage avec verification des votes 

<?php 

//ler partie du script PHP 

if(isset($_POST["choix"])) 

{ 

if($_C00KIE["votant"] <^©& 



_C00KIE["vote"]) <-© 



Svote = $_C00KIE["vote"]; 



?> 



<!--Code JavaScript --> 
<script type="text/javascript" > 

alert('Vous avez deja vote pour <?php echo Svote ?>!')<—© 
</script> 
<!-- 2 eme partie du script PHP--> 
<?php 
} 

else 
{ 
Svote = S_C00KIE["vote"]; 
setcookiet "votant" , "true" , timet )+300) ; 
setcookiet "vote", "(S_P0ST[' choix' ]}" ,time( )+300) ; 
//enregistrement du vote dans un fichier --> voir chapitre 11 
if (fil e_existsCsondage.txt") ) 
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if ($id_file=fopen ("sondage.txt" , "a") ) 
{ 
flock($id_file,2); 

fwrite($id_file,$_POST['choix , ]."\n"); 
flock($id_file,3); 
fclose($id_file) ; 
} 

el se 

{ echo "Fichier inaccessible";} 
} 

else 
{ 
$id_file=fopen( "sondage.txt" , "w" ) ; 
fwrite($id_file,$_POST[ , choix']."\n"); 
fclose($id_file) ; 
} 
// Fin de l'enregistrement 
?> 
<!--Code JavaScript --> 
<script type="text/javascript" > 

alertt'Merci de votre vote pour <?php echo $_P0ST["choix"] ?> ! ' ) 
</script> 
<!-- 3 erne partie du script PHP--> 
<?php 

} 
) 

?> 
<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 
<meta http-equiv="content-type" content="text/html ; charset=iso-8859-l" /> 
<title>Sondage </title> 
</head> 
<body> 
<h2>Bienvenue sur le site PHP 5 </h2> 
<!-- "<?php echo $_SERVER[ ' PHP_SELF' ] ?>" --> 
<form method="post" action="<?php echo $_SERVER[ ' PHP_SELF' ] ?>"> 
<fieldset> 
<legend>Votez pour votre technologie Internet preferee</legend> 
<table><tbody> 
<tr> 

<td>Choix 1 : PHP/MySQL</td> 
<td> 

<input type="radio" name="choix" value="PHP et MySQL" /> 
</td> 
</tr> 
<tr> 
<td>Choix 2 : ASP.Net</td> 
<td> 
<input type="radio" name="choix" value="ASP.Net" /> 
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</td> 

</tr> 
<tr> 
<td>Choix 3 : JSP </td> 
<td> 

<input type="radio" name="choix" value="JSP" /> 
</td> 
</tr> 
<tr> 
<td><b>Votez ! </b></td> 
<td> 

<input type=" submit" val ue="ENVOI" /> 
</td> 
</tr> 
</tbody> 
</table> 
</fieldset> 
</form> 



</body> 
</html> 
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Figure 12-1 

Page de sondage utilisant cookies et boites d'alerte JavaScript 



Les sessions 



Le protocole HTTP, que vous utilisez chaque fois que vous voulez visualisez une page 
Web, est un protocole de transmission dit sans etat. En d'autres termes, quand vous 
entrez l'adresse d'un site dans votre navigateur, le protocole HTTP la transmet au serveur 
puis vous renvoie le fichier XTML correspondant avant de passer aussitot a autre chose. 
Si, a partir de la page d'accueil, vous cliquez sur un lien vers une autre page du meme 
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site, rien ne lui permet de savoir que ces deux requetes emanent du meme poste client. II 
est done a priori impossible de conserver des informations provenant d'une page pour les 
utiliser dans une autre. 

L' introduction du support des sessions dans la version 4 de PHP permet de conserver ces 
informations de facon simple et de les reutiliser dans toutes les pages d'un site pour un 
meme visiteur. Aucun autre visiteur n'a acces a ces donnees. 

Le mecanisme des sessions 

L'utilisation du mecanisme des sessions obeit aux etapes generales suivantes : 

1. Ouverture d'une session dans chaque page ayant acces aux donnees a l'aide de la 
fonction session_start() de syntaxe : boolean session_start( ). Dans laplupart des cas, 
e'est-a-dire quand les sessions utilisent des cookies, cet appel est la premiere instruc- 
tion du script. 

2. Chaque utilisateur se voit attribuer un identifiant de session, qui est une suite de 
26 caracteres aleatoires. Lie a la session en cours, et done different lors d'une autre 
connexion, cet identifiant est transmis d' une page a une autre de deux manieres diffe- 
rentes, soit en etant ecrit dans un cookie sur le poste client, soit en etant ajoute a 
l'URL de la page cible d'un lien. 

3. Definition des variables de session, e'est-a-dire des valeurs qui seront accessibles 
dans toutes les pages du site qui utilisent la fonction session_start( ). Cela se realise 
en utilisant le tableau superglobal $_SESSI0N, dont les cles sont les noms des variables. 
A la difference des cookies, les noms et valeurs des variables sont stockes sur le 
serveur et non sur le poste client. Les variables sont generalement stockees dans le 
dossier /tmp du serveur, mais il vous appartient de verifier aupres de votre hebergeur 
le nom du dossier de stockage, certains d'entre eux vous obligeant a creer vous-meme 
sur le serveur un dossier nomine, par exemple, sessions. En l'absence d'un tel 
dossier, les sessions ne fonctionnent pas. Les fichiers contenant les donnees ont pour 
nom 1'identifiant de session, auquel est ajoute le prefixe sess_. lis ont la meme struc- 
ture qu'un fichier texte. 

4. Lecture des variables de session dans chaque page en fonction des besoins a l'aide du 
tableau superglobal $_SESSI0N. 

5. Fermeture de la session apres destruction eventuelle des variables de session. 

Session avec cookie 

La maniere la plus simple de transmettre 1'identifiant de session est d'utiliser un cookie. 
II faut pour cela que la directive sessi on . use_cooki es du fichier php . i ni ait la valeur on et 
plus fondamentalement que le poste client accepte les cookies. C'est pour cette raison 
que Ton voit couramment sur les sites de commerce en ligne un avertissement du type 
« pour acceder a ce service, vous devez accepter les cookies ». Vous verrez par la suite 
comment gerer les sessions en cas de refus absolu des cookies par le client. 
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Vous n'avez pas a coder vous-meme dans le script l'ecriture du cookie, PHP se chargeant 
de l'envoyer immediatement quand vous appelez la fonction session_start() pour la 
premiere fois. Si ces conditions sont remplies, vous n'avez a vous preoccuper de rien, si 
ce n'est de faire commencer chaque page par l'appel de la fonction sessi on_start( ). 



La directive session. auto_start 

Si la directive session. auto_start a la valeur on, vous n'avez meme pas a utiliser la fonction 
session_start( ), le serveur s'en chargeant pour toutes les pages du site. Cette directive est toutefois 
rarement activee. 



Les variables de session sont definies par le biais du tableau $_SESSI0N de la maniere 
suivante : 

$_SESSION['mavar']= mavaleur; 
ou encore : 

$_SESSION['mavar']= $ma variable; 
La valeur est ensuite lisible dans toutes les pages en ecrivant simplement : 

echo $_SESSION['mavar']; 

L'utilisation des sessions se revele done beaucoup plus simple qu'il n'y parait. 

Le code de gestion elementaire de session comprendrait, par exemple, les deux pages 
suivantes : 

• La premiere page demarre une session (repere Q) puis enregistre une variable de 
session (repere ©) et cree un lien vers la deuxieme page, nommee "deux.php" : 

<?php 

session_start( ) ; <— O 

$nom="Jean" ; 

$_SESSION['nom']=$nom; <-© 

echo "<a href=\"deux.php\">Vers la page DEUX </a>"; 

?> 

La deuxieme page demarre egalement une session (repere ©) puis a acces a la varia- 
ble de session de la page precedente (repere O) : 

<?php 

session_start( ) ; <— © 

echo "<br /> Bonjour " ,$_SESSI0N[ 'nom' ] ; ^O 

?> 

Pages a acces reserve par une authentification 

Vous allez maintenant creer une application plus complete utilisant le mecanisme des 
sessions. 



L'exemple 12-4 suivant est compose de trois fichiers correspondant a trois pages du site. 
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L'objectif est de limiter l'acces du site aux seuls utilisateurs enregistres dotes d'un login 
et d'un mot de passe. 

Exemple 12-4. Acces reserve et identification 

Cet exemple est constitue de trois fichiers, pageindex.php, pagehtml . php et pagephp.php. 

Sur la page d'accueil, le script cree un formulaire classique d'authentification, dans 
lequel le visiteur doit saisir son login et son mot de passe (voir la figure 12-2). 

Le script commence par ouvrir une session (repere Q ' puis verifie si le login et le code 
sont corrects (repere ©). II va de soi que sur un site reel le login et le code ne figureraient 
pas dans le script mais seraient lus dans une base de donnees. 

Si l'acces est autorise, la variable $_SESSI0N[ ' acces ' ] est definie avec la valeur "oui " et la 
variable $_SESSION['nom'] recupere le login du visiteur. Cette page contient deux liens 
vers les pages XHTML et PHP et affiche le nombre de fois que chaque page a ete vue 
pendant la session. Vous utilisez pour cela les variables $_SESSI0N[ ' html '] et $_SESSI0N 
['php'], dont les valeurs sont definies dans les fichiers pagehtml .php et pagephp.php. Cela 
montre bien qu'une variable de session definie dans une page est visible dans les autres 
pages (reperes et ©). 

Script de la page d'accueil pageindex.php : 

<?php 

session_start( ) ; <— O 

if($_POST['login']=="Machin" && $_P0ST[ 'pass' ]=="4567" )<-© 

{ 

$_SESSI0N[ ' acces ']="oui"; <— © 

$_SESSI0N[ ' nom' ]=$_P0ST[ 'login'] ; <-© 
} 

?> 
<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>LES SESSIONS</title> 
</head> 
<body> 
<div> 

<form method="post" action="<?php echo $_SERVER[ ' PHP_SELF' ] ?>"> 
<fieldset> 

<legend>Acces reserve aux personnes autorisees: Identifiez vous !</legend> 
<1 abel >Logi n : </label><input type="text" name="login" /> 
<label>Pass :  </label><input type="password" name="pass" /> 
<input type="submit" name="envoi" value="Entrer"/> 
</fieldset> 
</form> 

Visiter les pages du site <br /> 
<ul> 
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<li><a href="pagehtml.php">Page XHTML </a><? if (isset($_SESSION[ 'html'] ) ! 



**echo 

<li><a 

^»echo 

</ul> 

</div> 

</body> 

</html> 



" vue ". $_SESSION[ 'html ' ] . " fois"; ?> </li><-© 
href="pagephp.php">Page PHP 5</a><? if (isset($_SESSION['php' ] ) ) 
" vue ". $_SESSION['php']. " fois"; ?> </li><^© 
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Visiter les pages du site 

• Page (X)HTML 

• Page PHP 



£} Terming 



tf Internet; 



Figure 12-2 

Page d'accueil 



Les pages definies par les fichiers pagephp.php et pagehtml . php sont celles qui vont affi- 
cher le contenu informatif reserve. Elles ont une structure identique, et vous pourriez en 
creer une quantite sur le meme modele pour elargir le contenu du site. Chacune d' elles 
commence par demarrer une session (reperes ©). Elles sont protegees contre tout acces 
non autorise, car si une personne essaye de les afficher directement dans un navigateur, 
elle est redirigee (reperes©) vers la page d'accueil tant que la variable $_SESSI0N 
[ 'acces ' ] n'a pas la valeur "oui " (reperes ©). 

Si 1' acces est autorise, le script affiche un message de bienvenue incorporant le nom du 
visiteur (reperes ©) puis incremente un compteur de visite pour la page (reperes ©). II 
affiche enfln a la suite des liens vers les autres pages le nombre de fois qu'elles ont ete 
visitees (reperes © et ©). 

Script de la page pagephp.php : 

<?php 

session_start( ) ; <— © 

if ($_SESSI0N[ ' acces' ]! = "oui") <-© 

{ 

header("Location:pageindex.php") ; <— © 

} 

else 
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echo "<h4>Bonjour ". $_SESSI0N[ 'nom' ] . "</h4>" ; <-© 

$_SESSION['php'] ++; <^@ 
} 

?> 
<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>La page de PHP 5</title> 
</head> 
<body> 

<h4> Acces reserve aux personnes autorisees</h4> 
<p> Visiter les autres pages du site : 

<?php echo "Page PHP vue ". $_SESSION[ 'php' ] . " fois"; ?> <^0 
<ul> 

<li><a href="pageindex.php">Page d'accueil </a></li> 
<li><a href="pagehtml .php">Page XHTML </a> 

<? if(isset($_SESSION['html']))echo " vue ". $_SESSION[ ' html ' ] . " fois"; ?> 
*</li> ^O 
</ul> 
</p> 

<h3>Contenu de la page PHP 5</h3> 
</body> 
</html> 



Figure 12-3 
Page PHP 
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Script de la page pagehtml .php : 

<?php 

session_start( ) ; <— O 
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if($_SESSION['acces']! = "oui") <-© 

{ 

header ("Locati on :pageindex.php") ; <— © 

} 

else 

{ 

echo "<h4>Bonjour ". $_SESSI0N[ 'nom' ] . "</h4>" ; <-© 

$_SESSION['html '] ++; <-© 
} 

?> 
<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>La page du (X)HTML.</title> 
</head> 
<body> 

<h4> Acces reserve aux personnes autorisees</h4> 
<p> Visiter les autres pages du site : 

<?php echo "Page XHTML vue ". $_SESSION[ ' html ' ] . " fois"; ?><-© 
<ul> 

<li><a href="pageindex.php">Page d'accueil </a> </li> 
<li><a href="pagephp.php">Page PHP 5</a> 

<? if(isset($_SESSION['php']))echo " vue ". $_SESSION[ 'php' ] . " fois"; ?><-© 
</li> 
</ul> 

<h3>Contenu de la page XHTML</h3> 
</body> 
</html> 
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Figure 12-4 
Page XHTML 
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La gestion de panier 

Une utilisation classique des cookies est la gestion de panier sur un site de commerce en 
ligne dans lequel les articles sont selectionnes les uns apres les autres et stockes dans un 
panier, ou Caddie. 

L'exemple 12-5 demande de remplir un bon de commande en completant un formulaire. 
Ce dernier ne permet la saisie que d'un article a la fois. La demarche serait la meme si 
le client pouvait choisir des articles dans differentes pages et qu'il fallait conserver 
l'ensemble de ces choix jusqu'a la fin de sa commande. 



Dans la premiere version de PHP 5, il etait possible d'utiliser le tableau $_SESSI0N en tant que tableau 
multidimensionnel. Pour enregistrer plusieurs valeurs de norms dans la meme session on pouvait ecrire : 

$_SESSION['nom , ][]="Pierre"; 

Puis, a la suite d'une autre saisie : 

$_SESSION[ , nom , ][]="Paul"; 

Et ainsi de suite. C'est de cette maniere que nous avions traite l'exemple 12-5 dans la premiere edition de 
I'ouvrage, mais cette possibilite ne fonctionne desormais plus. 



Si la commande comportait plus d'un article, la saisie du premier article serait perdue 
lors de la saisie du deuxieme. L'usage des sessions permet de conserver l'ensemble des 
articles saisis jusqu'a la fin de la commande. 

Le formulaire de saisie comprend trois zones de saisie ainsi que trois boutons Submit, 
chacun correspondant a une action particuliere. Le bouton Ajouter ajoute un article a la 
commande, le bouton Verifier affiche l'ensemble de la commande et le montant total et le 
bouton Enregistrer stocke la commande dans un fichier texte sur le serveur par commo- 
dity car, en realite, il serait preferable de stacker les informations dans une base de donnees. 

La partie PHP du script est divisee en trois parties, chacune gerant une des actions 
possibles : 

• Si l'utilisateur clique sur le bouton Ajouter, le script recupere les informations dans les 
variables $code, $article et $prix (reperes O et ©) puis definit les variables de 
session $_SESSION['code'], $_SESSI0N[ 'article'] et $_SESSION['prix'] (reperes ©. 
et @). Pour sauvegarder les donnees de plusieurs saisies, nous les enregistrons dans la 
meme variable en les concatenant et en les separant par les caracteres arbitrairement 
choisis « // », comme nous l'avons fait pour l'enregistrement de chaines dans un 
fichier au chapitre 11. La variable $_SESSION['code'] contiendrait, par exemple, la 
chaine suivante apres la saisie de trois codes : "codel//code2//code3". 

• Si l'utilisateur clique sur le bouton Verifier, le script affiche l'ensemble des lignes de 
la commande plus une ligne indiquant le prix total dans un tableau XHTML. II nous 
faut d'abord recuperer toutes les valeurs enregistrees dans les chaines precedentes. 
Ceci est fait en creant trois tableaux a l'aide de la fonction expl ode( ) appliquee succes- 
sivement aux trois variables de session (reperes O O et ©)• Une boucle for permet 
alors d'afficher toutes les donnees en parcourant les trois tableaux crees (repere ©). 
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Le prix total est calcule en accumulant les valeurs successives des variables $tab_ 
prix[$i] (repere ©). 

• Sil' utilisateur clique sur le bouton Enregistrer, le script enregistre dans un fichier texte 
toutes les donnees saisies en parcourant de la meme facon les tableaux $tab_code, 
$tab_article et $tab_prix (repere ©). 

Le script se termine en reinitialisant la variable $_P0ST[ "envoi"] de facon qu'elle ne 
conserve pas sa derniere valeur (repere ©). 

La figure 12-5 illustre une page de saisie des articles et la figure 12-6 l'ensemble des 
donnees d'une commande. 



Exemple 12-5. Commande en ligne 

<?php 

session_start( ) ; 

//AJOUTER 

if($_POST["envoi"]=="AJOUTER" && $_P0ST["code"] !="" && 

*$_POST["article"]! = "" && $_P0ST["prix"] ! = "" ) 

{ 

$code=$_POST["code"]; ^© 

$article= $_POST["article"] ; <-© 

$prix= $_P0ST["prix"]; <-© 

$_SESSION['code']= $_SESSI0N[ 'code' ]."//" .$code; <-© 

$_SESSION['article']= $_SESSI0N[ 'article' ]."//" .Sarticle; <-0 

$_SESSION['prix']= $_SESSION['prix' ]."//" .$prix; <-0 
} 

//VERIFIER 

if($_P0ST[ "envoi "]==" VERIFIER") 
{ 

echo "<table border=\"l\" >"; 

echo "<tr><td colspan=\"3\"Xb>Recapitulatif de votre commande</b></td>" ; 

echo "<trXth> code </thXth> article </ thXth>  

*»prix </th>" ; 

$total=0; 

$tab_code=explode("//",$_SESSION['code']); <-© 

$tab_article=explode("//",$_SESSION ['article']); <-© 

$tab_prix=explode("//",$_SESSION['prix']): <-© 

for($i=l;$i<count($tab_code);$i++) <— © 

{ 
echo "<tr> <td>{$tab_code[$i]}</td> <td>{$tab_article[$i ]}</td><td> 
*»" .sprintf ( "i&Ol . 2f" , $tab_prix[$i ] ) . "</td>" ; 
$prixtotal+=$tab_prix[$i] ; <— © 



echo "<tr> <td colspan=2> PRIX TOTAL </td> <td>" .sprintf ("%01.2f" , 

«»</td>"; 

echo "</table>"; 
} 

//ENREGISTRER 
if($_POST["envoi"]=="ENREGISTRER") 



srixtotal ) . 
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$i df i 1 e=f open( "commande . txt" ,w) ; 

// 

$tab_code=explode('7/",$_SESSI0N[ , code']); 

$tab_article=explode("//",$_SESSION[' article']); 

$tab_prix=explode('7/",$_SESSI0N['prix']); 

for($i=0;$i<count($tab_code);$i++) <^© 

{ 
fwrite($idfile. $tab_code[$i ] . " ; " .$tab_article[$i ] . " ; " .$tab_prix[$i] . 
*\n"); 

} 

fclose(Sidfile) ; 
} 

//LOGOUT 

if($_P0ST["envoi"]=="L0G0UT") 
{ 

session_unset( ) ; <— © 

session_destroy( ) ; <— © 

echo "<h3>La session est terminee</h3>" ; 
} 

$_P0ST[ "envoi "] = ""; <-© 
?> 
<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l"> 
<title>Gestion de panier</title> 
</head> 
<body> 

<form action="<?php $_SERVER[ ' PHP_SELF' ] ?>" method="post" 
*»enctype="appl ication/x-www-form-url encoded" > 
<fieldset> 

<legend><b>Saisies d'articles</b></legend> 
<table> 
<tbody> 
<tr> 

<th>code : </th> 

<td> <input type="text" name="code" /></td> 
</tr> 
<tr> 

<th>article : </th> 

<td><input type="text" name="article" /></td> 
</tr> 
<tr> 

<th>prix :</th> 

<tdXinput type="text" name="prix" /></td> 
</tr> 
<tr> 
<td colspan="3"> 
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<input type=" submit" name="envoi" value="AJOUTER" /> 






<input type="submit" name="envoi" val ue="VERIFIER" /> 






<input type="submit" name="envoi" value="ENREGISTRER" /> 






<input type=" submit" name="envoi " valuer" LOGOUT" /> 






</td> 






</tr> 






</tbody> 






</table> 






</fieldset> 






</form> 






</body> 






</html> 
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Figure 12-5 

Page de saisie de commandes 



iRecapitulatif de votre commande 


| code article | prix 
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Figure 12-6 

Affichage du contenu du punier 



Pour un site reel en production, il est bon d'ajouter au formulaire un quatrieme bouton, 
nomine Deconnexion, ou Logout, permettant a l'internaute de terminer la session et de 
faire disparaitre les donnees saisies, en particulier son code d'acces. Cette precaution 
n'est pas inutile, surtout si le poste client est utilise successivement par plusieurs personnes 
et e'est ce que nous avons mis en place dans le code de l'exemple. 

Pour detruire toutes les variables de la session, vous utilisez la fonction session„unset( ) 
(repere ©) sans parametre et qui ne retourne aucune valeur. Pour terminer la session, 
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vous disposez de la fonction sessi on_destroy ( ) (repere ©) egalement appelee sans para- 
metre, qui retourne une valeur booleenne TRUE si l'operation est realisee et FALSE dans le 
cas contraire. 

Pour creer le bouton Submit, il vous resterait a aj outer le code HTML suivant : 

<input type="submit" name="envoi " value="L0G0UT" /> 

puis, dans le script PHP, le code correspondant suivant : 

if($_P0ST["envoi"]=="L0G0UT") 
{ 

session_unset( ) ; 

sessi on_destroy( ) ; 

echo "<h3>La session est terminee</h3>" ; 
} 

Si l'utilisateur clique sur le bouton "LOGOUT", personne ne peut plus afficher sa 
commande, lui y compris. 

Les sessions sans cookie 

Si vous desactivez les cookies dans votre navigateur — dans Firefox, par exemple, via 
Outils, Options, Cookies — et que vous tentiez de tester les exemples 12-4 et 12-5, vous 
constateriez qu'ils ne fonctionnent pas. PHP ne peut plus enregistrer l'identifiant de 
session dans un cookie sur le poste client. II vous faut done transmettre cet identifiant 
entre toutes les pages du site d'une autre facon. 

Le nom de la session, par defaut PHPSESSID, et l'identifiant aleatoire de session sont main- 
tenant contenus dans la constante nommee SID, sous la forme : 

PHPSESSID= uscbk53ualdiv44kbvp8v5cnq6 

La transmission du nom et de la valeur de l'identifiant se fait en ajoutant a la fin de 
chaque adresse definie dans un lien le caractere ? suivi de la valeur de la constante SID. 

Pour la page pageindex.php, par exemple, il vous faudrait reecrire la liste des liens de la 
maniere suivante : 

<p> Visiter les pages du site <br /> 

<ul> 

<li><a href="pagehtml2.php?<?php echo SID?>">Page XHTML </a><?php if(isset 

*($_SESSION['htmr])) echo " vue ". $_SESSI0N[ ' html' ] . " fois"; ?> </li> 

<li><a href="pagephp2.php?<?php echo SID?>">Page PHP 5</aX?php if (isset 

*($_SESSION['php'])) echo " vue ". $_SESSI0N[ 'php' ] . " fois"; ?> </li> 

</ul> 

et faire de meme avec les autres pages du site pour chaque lien. 

Le nom de la session est recuperable en appelant la fonction session_name( ) sans parame- 
tre et l'identifiant de session en appelant la fonction sessi on_id(), qui retourne une 
chaine de caracteres. 
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L'usage de la constante SID est de loin preferable pour transmettre 1'identifiant vers 
d'autres pages. 



L'envoi de mails 

Vous avez deja vu au chapitre 6, consacre aux formulaires, la possibilite de communica- 
tion par e-mail entre un internaute et un site Web pour transmettre les donnees d'un 
formulaire. 

Vous allez decouvrir ici la possibilite d'envoyer des e-mails du serveur vers le poste 
client. Pour peu que votre serveur vous 1'autorise, cette fonctionnalite vous permet 
d'envoyer un e-mail contenant un identifiant et un code d'acces a une personne qui 
s'inscrit sur un forum de discussion ou un site en dormant son adresse e-mail. Ce controle 
evite, par exemple, les saisies fantaisistes ou, pire, les usurpations d' adresse e-mail. 

Sur un site de commerce en ligne, cette fonction donne la possibilite d'envoyer automa- 
tiquement une confirmation de commande sitot qu'elle est passee. 



La fonction mail() 



La premiere chose a faire est bien entendu de vous assurer aupres de votre hebergeur que 
vous disposez de la fonction mai 1 ( ). De nombreux hebergeurs, en particulier les gratuits, 
desactivent la fonction d'envoi d'e-mail pour eviter le Spam et surtout pour ne pas 
surcharger leurs serveurs. Certains autres reecrivent la fonction mai 1 ( ) pour en limiter les 
possibilites, le nombre d'envois par exemple. 

Cette verification peut etre realisee en utilisant 1' exemple 7-1 du chapitre 7 (fichier 
fonctionl . php), qui affiche la liste des fonctions disponibles sur le serveur. Pour l'heber- 
gement d'un site professionnel, la possibilite d'envoi d'e-mail peut etre un critere de 
selection determinant. 

La fonction de base d'envoi d'e-mail se nomme done mai 1 ( ). Sa syntaxe est la suivante : 

j boolean mail($dest, $objet, $texte, [$entete]) 
Ses parametres sont les suivants : 

• $dest est une chaine contenant l'adresse e-mail du destinataire. Pour envoyer le meme 
e-mail a plusieurs adresses, il faut separer chacune d'elles par une virgule. 

• $objet est une chaine contenant le texte qui apparait dans la colonne Objet du logiciel 
de courrier du destinataire. 

• $texte est une chaine donnant le contenu reel du message, qui peut etre au format texte 
ou au format HTML. 

• $entete est une chaine contenant les en-tetes necessaires a l'envoi d'e-mails, lorsque 
ces derniers ne sont pas au format texte. Chaque en-tete se termine par la sequence 
"\n" sur un serveur Linux et "\r\n" sous Windows. 
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La fonction mail ( ) retourne la valeur booleenne TRUE si le message est expedie et FALSE 
dans le cas contraire. La verification que vous pouvez operer grace a cette valeur de 
retour ne signifie pas que l'e-mail est bien recu et ne presage en rien de problemes tels 
qu'une erreur dans l'adresse ou une adresse inexistante. Dans ces derniers cas, vous rece- 
vez un message d'erreur a l'adresse de l'expediteur (sauf specification contraire) dans un 
delai qui peut aller de quelques minutes a plusieurs jours. 



Envoi d'e-mail au format texte 

Votre premier exemple n'utilise que les trois premiers parametres de la fonction mai 1 ( ) . 

A partir d'un formulaire de commande de livres, dans lequel le client saisit sa commande 
sous la forme d'un nom d'article (repere ©), d'une quantite (repere @), de son nom 
(repere ©) et de son adresse postale (repere ©) et enfin de son e-mail (repere ©), le 
script lui envoie un e-mail de confirmation recapitulant la commande. 

Le script contient la definition d'un tableau contenant le tarif de chaque livre (repere ©). 
II ne contient ici que trois titres. Dans la realite, le tarif serait bien entendu contenu dans 
la base de donnees interrogee. Comme vous en avez 1' habitude, le script verifie ensuite 
1' existence des variables envoyees par le formulaire (repere Q) puis recherche le prix de 
1' article commande (repere ©) et cree le contenu du message dans la variable $text en 
concatenant les differentes informations envoyees par le client (repere ©). 

L'e-mail de confirmation est alors envoye (repere ©), et une verification est operee pour 
savoir si l'operation s'est bien deroulee et afficher un avis au client. 

La figure 12-7 illustre la page de commande de livres. 
•* Exemple 12-6 Envoi d'un e-mail de confirmation 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<style type="text/css"> 

td {background-color:yel low;color:bl lie; font-family: arial, helvetica, sans-serif; 
^font-size: 12pt;font-weight: bold;} 
</style> 

<title>Votre commande</title> 
</head> 
<body> 

<div><h3>Articles </h3> "XHTML et CSS" : 29.90 n<br />"PHP 5" : 29.50 n<br /> 
*"MySQL" : 19.75 n<br /Xbr /></div> 
<form action="<?= $_SERVER[ ' PHP_SELF' ] ?> " method="post" 
enctype="appl icati on /x-www-form-url encoded" > 
<fieldset> 

<legend>Passez votre commande</legend> 
<table border="0" > 

<tr> 
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<td>Article</td> 

<td><input type="text" name="article" size="40" maxlength="256" /X/td><— O 
</tr> 
<tr> 
<td>Quantite</td> 

<tdXinput type="text" name="quantite" size="40" /></td> <— Q 
</tr> 
<tr> 
<td>Nom</td> 

<tdXinput type="text" name="nom" size="40" maxlength="256" /></td><— Q 
</tr> 
<tr> 
<td>Adresse</td> 

<td><input type="text" name="adresse" size="40" maxlength="256" /></td><— O 
</tr> 
<tr> 
<td>Mail</td> 

<tdXinput type="text" name="mail" size="40" maxlength="256" /></td><— © 
</tr> 
<tr > 
<td col span="2">  <input type="submit" name="envoi "value=" Commander 
*• /></td> 
</tr> 
</table> 
</fieldset> 
</form> 

<!— SCRIPT PHP --> 
<?php 

//Creation du tarif des livres 

$tarif= arrayC'XHTML et CSS"=>29.90, "PHP 5"=>29.50, "MySQL"=>19 . 75 ) ; <-© 
//Gestion de la commande 

if(isset($_POST['article'])&& isset($_POST['quantite']) && isset($_POST['nom' ]) 
*•&& isset($_POST['adresse']) && isset($_POST[ 'mail' ] ) )<-© 
{ 

$article=$_POST[ 'article']; 
$prix= $tarif [Sarticle]; <— © 
$objet="Confi rmation de commande"; 
//Contenu du mail 
$text.= "Nous avons bien recu votre commande de : \n"; 
$text.="{$_POST['quantite']} livres "; 

$text.= $_POST['article' ] . " au prix unitaire de : ". $prix ." euros \n"; 
$text.= "Soit un prix total de : ". $prix * $_P0ST[ 'quantite' ] ." euros \n"; 
$text.="Adresse de livraison : \n". $_P0ST[ 'nom' ] . " \n"; 
$text.=$_POST['adresse']. " \n"; 
$text . = " Cordialement"; <— Q 
if (mail ($_P0ST[ 'mail ' ] ,$objet,$text) ) <— © 
{ 

echo "<hl>Vous allez recevoir un mail de confirmation </ hl>"; 
} 

else 
{ 
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echo "<hl>Le mail n'a pas ete envoye: recommencez! </hl>"; 



?> 

</body> 

</html> 
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Figure 12-7 

Bon de commande de livres 

La figure 12-8 illustre l'e-mail tel qu'il peut etre visualise par le client du site dans 
Outlook Express. 



De : webmaster^" ..,."' A: _ !s@ 
Objet : Confirmation de commande 



Nous avons bien recu votre commande de : 
3 livres PHP5 au prix unitaire de : 29 euros 
Soit un prix total de : 87 euros 
Adresse de Hvraison : 
Anatole EICOD 
21 rue Compoint 75018 PARIS 
Cofdialement 



Figure 12-8 

E-mail recu par le client 

En utilisant le quatrieme parametre de la fonction mai 1 ( ), il est possible pour des applica- 
tions particulieres de mettre en copie simple d'autres destinataires (option Cc dans 
Outlook Express : les destinataires voient 1' adresse de tous les autres) ou en copie cachee 



PHP 5 



(option Cci : les destinataires ne voient pas l'adresse des autres). Ce parametre permet 
d'ajouter des en-tetes dans l'e-mail et de definir leur valeur. 

Le tableau 12-1 recapitule l'ensemble des en-tetes utilisables dans l'envoi des mails. 
Tableau 12-1 - En-tetes utilisables au format texte ou HTML 



En tete Definition 

From: Adresse de I'expediteur de l'e-mail si vous souhaitez qu'elle soit differente de celle qui est ecrite 

dans le corps du message. 

cc : Adresse e-mail du destinataire en copie. S'il y en a plusieurs, elles doivent etre separees par des 

virgules. 

bcc : Adresse du destinataire en copie cachee 

Repl y-To : Adresse a laquelle parviendra la reponse eventuelle du destinataire s'il redige son e-mail en utilisant 

le bouton Repondre. 

X-Mailer: Norn du logiciel d'envoi du courrier 

Date: Date de l'e-mail au format JJ MM AAAA h:m:s +0N00, dans laquelle N est le decalage horaire. 



En utilisant ces en-tetes dans le quatrieme parametre de la fonction mai 1 ( ), le code defi- 
nissant le contenu de l'e-mail de l'exemple precedent devient : 



$text.= "Nous avons bien recu votre commande de : \n"; 
$text.="{$_POST['quantite']} livres "; 
$text.= $_P0ST[ 'article' ] . " au prix unitaire de : 



$prix 



$text.= "Soit un prix total de : 

$text.="Adresse de livraison : \n 

$text.=$_POST['adresse']. " \n"; 

$text .=" Cordialement" ; 

//Ecriture des en-tetes 

$entete=" From: ventes@machin.com" ; 

$entete="cc: compta@machin.com" ; 

$entete.="bcc: jul ia@machin.com" ; 

$entete.="Reply-To: reponse@machin.com" ; 

$entete.="X-Mailer: PHP" .phpversion( ) ; 

$entete.="Date:".date("D, j M Y H:i:s +0100") 
if (mail ($_P0ST[ 'mail ' ] ,$objet ,$text,$entete) ) 

{echo "<hl>Le mail a ete envoye </ hl>";) 
else 

{ echo "<hl>l_e mail n'a pas ete envoye </hl>"; 



$prix * $_POST['quantite'] 
$_P0ST['nom']. " \n"; 



euros \n"; 
. " euros \n"; 



Envoi d'e-mail au format HTML 

L'envoi d'e-mail au format HTML permet de rendre l'aspect visuel du message beau- 
coup plus agreable car il se presente comme une page HTML, avec tout ce qu'elle peut 
comporter, comme des titres, des image ou des liens. 
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Cette methode est evidemment recommandee pour l'envoi d'e-mails publicitaires ou 
d'information a une liste de personnes inscrites a une liste de distribution (mailing list). 

Pour realiser ce type d'e-mail, vous utilisez encore le quatrieme parametre de la fonction 
mai I ( ) en ajoutant cette fois les en-tetes MIME detailles au tableau 12-2. Chaque en-tete 
se termine par la sequence "\n". 



En-tete MIME 

Les types MIME [Multipurpose Internet Mail Extensions) ont ete crees pour permettre d'inserer des docu- 
ments (images, sons, texte HTML, etc.) dans un courrier. 



Pour incorporer des images dans un e-mail au format HTML, vous ecrivez le code 
HTML de la meme facon que pour une page Web classique mais en veillant que l'attribut 
href de l'element <img> contienne l'adresse absolue des images employees. Si cette 
methode presente 1' inconvenient d'obliger le destinataire a etre en ligne pour pouvoir 
visualiser les images, elle rend en contrepartie les messages moins lourds. 

Tableau 12-2 - En-tetes MIME 



En tete 


Definition 


MIME-Version: 


Indique que le contenu de I'e-mail est conforme aux specifications MIME ainsi que la 
version utilisee (actuellement 1.0 ou 1.1). Cet en-tete doit etre ecrit le premier : 
MIME-Version: 1.0 


Content-Type: 


Definit le type de contenu de I'e-mail a I'aide d'un type MIME ainsi que le jeu de carac- 

teres a utiliser : 

Content-Type: text/html ;charset=iso-8859-l 


Content-Transfer- 
Encoding: 


Definit le mode de codage des documents, en particulier des images liees a I'e-mail. 
II y a plusieurs valeurs possibles, mais il est preferable de choisir la valeur 8bi t : 

Content-Transfer- Encoding: 8bit 



L'exemple 12-7 envoie un e-mail d'annonce d'un grand evenement a une personne 
(repere ©). II serait bien entendu possible de l'ameliorer en creant une boucle qui lirait 
un tableau contenant la liste de tous les destinataires inscrits sur le site qui delivre 1' infor- 
mation. 

Le texte de I'e-mail est compose uniquement de code XHTML, contenant un gros titre, 
une image (repere ©) et deux liens hypertextes (reperes © et ©). Ce contenu pourrait 
etre parfaitement affiche dans un navigateur quelconque en tant que page Web. 

Les en-tetes utilises definissent 1' utilisation des specifications MIME (repere ©), le type 
de contenu de I'e-mail (repere ©), le type d'encodage (repere Q> et l'adresse d'origine 
(repere ©). Ce sont eux qui vont permettre l'affichage du contenu de la variable $text 
comme une page HTML par le logiciel de messagerie. La fonction mai 1 ( ) recoit ensuite 
ces quatre parametres, realise l'envoi de I'e-mail et affiche un message de confirmation 
(repere ©). 
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Exemple 12-7. Envoi d'e-mail au format HTML 



<?php 

$dest = "abonne@machin.com"; <— © 

$objet = "Test mail en HTML"; 

//Contenu HTML du mail 

$texte = "<html><head><title>Envoi de mail HTML</titleX/head> 

<body><hl>La bonne nouvelle du mois</hl> 

<b>Sortie de PHP 5 version f i nal e! </b> 

<img src=\"http: //static. php.net/www. php.net/images/php.gi f\" 

*alt=\"Logo PHP\" /> ^© 

<a href=\"http://www.php.net.\">Pl us d'infos ici</A><— © 

<p>Telecharger un installeur pour une utilisation en locaKbr /> 

<a href=\"http://www.phpathome.fr.tc\">Le site PHP@Home</A><— O 

</bodyX/html>"; 

//En tetes indispensables pour un mail en HTML 

$entete="MIME-Version: 1.0"; <— © 

Sentete .= "Content-Type:text/html ;charset=iso-8859-l\n" ; <— © 

Sentete .= "Content-Transfer-Encoding: 8bit\n";<— © 

Sentete .= "From: engels@funhtml.com \n";<— © 

/Envoi du mail 

f (mail ($dest,$objet,$texte,$entete)) <— © 

print "Le mail a ete envoye<br> <br />"; 



lse 



print "le mail n'a pas ete envoye<br />"; 



?> 



Dc: «cbfnostci@FunpJip .com A: 
Objet : Test mal en HTML 



■@fu nphp.com 



La bonne nouvelle du niois 




Sortie de PHP 5 version finale! 

Telenhargeriin instaKeiir poiir line ntilisatiftn en lonal 
Le site PHP@Home 



Figure 12-9 

E-mail en XHTML recti dans Outlook 
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Memo des fonctions 



boolean setcookie(string $nom, string $valeur,int $date, string chemin, string domaine.int 
securite) 

Ecrit le cookie nomme $nom dont le contenu est $val eur et la date d'expiration $date. Les parametres suivants indiquent 
le chemin et le nom du domaine qui peut acceder au cookie et s'il doit etre accessible par une connexion securisee 
(valeur 1). 

boolean mail (string $dest, string $objet, string $text, string $entete) 

Envoie I'e-mail dont le destinataire, I'objet et le texte sont precises. Les en-tetes permettent d'envoyer des e-mails au 
format HTML. 

boolean session_start( ) 

Demarre une session. 

boolean session_destroy( ) 

Detruit la session en cours. 

void session_unset( ) 

Detruit toutes les variables de session. 

string session_name([string $nom]) 

Sans parametre, la fonction retourne le nom de la session. Avec un parametre, elle definit un nouveau nom de session. 

string session_id([string $id]) 

Sans parametre, la fonction retourne I'identifiant de la session. Avec un parametre, elle definit une nouvelle valeur pour 
I'identifiant. 



string session_save_path( [string $id]) 

Sans parametre, la fonction retourne le chemin d'acces au dossier qui stocke les donnees de la session. Avec un para- 
metre, elle definit un nouveau dossier de stockage. 

void session_write_close( ) 

Ecrit les variables de la session sur le serveur et ferme la session. 



Exercices 



Exercice 1 

Creez un formulaire de saisie des deux codes couleur preferes du visiteur du site pour la 
couleur de fond et le texte de la page. Enregistrez-les dans deux cookies valables deux 
mois. A l'ouverture de la page d'accueil, recuperez ces valeurs, et creez un style utilisant 
ces donnees. 

Exercice 2 

Meme exercice, mais en stockant les deux informations dans un meme cookie. 
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Exercice 3 

Apres avoir cree un formulaire de saisie du nom et du mot de passe du visiteur ainsi que 
d'une duree de validite puis avoir autorise l'acces au site, enregistrez un cookie contenant 
ces informations. Lors de la connexion suivante, le formulaire devra contenir ces infor- 
mations des l'affichage de la page. 

Exercice 4 

Enregistrez le nom de la page du site preferee du visiteur dans un cookie. Lors de sa 
connexion, il devra etre redirige automatiquement vers cette page. 

Exercice 5 

Envoyez un ensemble d' e-mails ay ant tous le meme objet et le me me contenu a partir 
d'une liste d'adresses contenue dans un tableau. 

Exercice 6 

Meme exercice, mais cette fois chaque objet et chaque contenu des e-mails doit etre 
different et extrait d'un tableau multidimensionnel. 

Exercice 7 

Reprenez 1' exercice 1 en enregistrant les preferences du visiteur dans des variables de 
session pour afficher toutes les pages du site avec ses couleurs preferees. 

Exercice 8 

Transformez le script de l'exemple 12-5 (commande en ligne) en permettant les saisies a 
partir de pages differentes et en creant sur chacune un bouton provoquant l'affichage de 
1' ensemble du panier a chaque demande. 
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Rappels sur les SGBDR 



Une base de donnees est un ensemble d' informations stockees sur un support et dote 
d'une certaine organisation. Votre carnet d'adresses en est un exemple elementaire, 
l'annuaire du telephone egalement, mais a une autre echelle. 

L'acces rapide a l'information via des reseaux comme ceux des entreprises puis par 
Internet a necessite la creation de systemes d'organisation des donnees permettant un 
acces rapide a l'information. Imaginez que vous deviez trouver toutes les personnes 
portant le meme nom dans un departement donne. La consultation de l'annuaire vous 
prendrait des heures. Face a de tels problemes, l'informatisation du stockage des donnees 
est devenue une necessite. C'est dans ce but qu'ont ete crees les SGBDR (Systeme de 
gestion de base de donnees relationnelle). 

L'objectif de ce chapitre n'est pas de vous fournir un cours complet sur les bases de 
donnees, loin de la. II s'agit simplement de rappeler les notions essentielles qui vous 
permettront, a partir d'un besoin particulier de stockage d'information, de structurer les 
differentes donnees dans une base. Pour approfondir le sujet de la conception des bases 
de donnees et en particulier la methode de conception UML (Unified Modeling 
Language, Langage de modelisation unifie en francais), mieux adaptee a la conception 
orientee objet, vous pouvez vous reporter utilement a l'ouvrage de Christian Soutou, 
De UML a SQL : Conception de bases de donnees, paru aux editions Eyrolles. 

L'organisation des donnees doit permettre de repondre a des contraintes precises, notam- 
ment les suivantes : 

• Les donnees doivent occuper le moins d'espace possible. 

• Les redondances d'information doivent etre evitees. 
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• Les mises a jour ou la suppression de donnees doivent laisser la base integre et ne pas 
creer d' incoherences. 

• La recherche d' informations doit etre rapide et sure. 
Vous allez done aborder successivement les phases suivantes : 

1. Elaboration du modele d' organisation des donnees a l'aide de la methode entite/asso- 
ciation. Cela entraine la creation d'un modele conceptuel de donnees (MCD), qui est 
une representation abstraite des donnees a stacker et des liens entre elles. 

2. Passage du modele ainsi cree au modele relationnel, qui est actuellement le plus 
courant. Cela entraine la creation d'un modele logique de donnees (MLD), qui est la 
representation d'un modele implantable dans un systeme particulier. 

3. Implementation dans un SGBDR (Systeme de gestion de base de donnees relation- 
nelle) particulier, comme MySQL ou SQLite, qui font l'objet des chapitres suivants. 

L'exemple qui servira de socle a tout ce chapitre est la modelisation de la base de donnees 
necessaire a la gestion d'un site de commerce en ligne. 



Le modele entite/association 

Le nom anglais du modele entite/association (Entity/Relationship) est a l'origine de la 
confusion que Ton retrouve souvent dans la definition d'une base de donnees relation- 
nelle (BDR). Certains auteurs definissent un BDR comme une base ayant des relations 
entre tables. Or une base est dite relationnelle si elle repose sur la notion de table, qui est 
la traduction du concept mathematique de relation entre ensembles. Une base de donnees 
peut en effet etre qualifiee de relationnelle et ne comporter qu'une seule table. 

Le modele entite/association permet la modelisation abstraite d'une base de donnees. 
II utilise un ensemble de conventions de representation graphique pour modeliser les 
differents concepts contenus dans une information et les liens qui existent entre eux. 
Les schemas realises sont similaires a ceux de la methode Merise et done differents de 
la notation UML. 



Les entites 

On appelle entite une representation d'un ensemble d'objets reels ou abstraits qui ont 
des caracteristiques communes. Une information du monde reel peut correspondre a 
plusieurs entites. Cette decomposition de 1' information en plusieurs entites, dont chacune 
a une nature differente, constitue la premiere etape du travail de conception. Si vous 
voulez modeliser une commande faite par un client, il apparait en premiere lecture au 
moins deux entites, une personne d'un cote et les articles qu'elles commande de 1' autre. 
Vous avez bien fait apparaitre deux entites de nature differente. Chaque personne reelle 
est une occurrence de 1' entite general e personne. 
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On distingue deux sortes d'entites : 

• Les entites fortes, qui ne dependent pas de l'existence d'une autre entite. C'est le cas, 
par exemple, d'une entite representant un personne ou un produit. 

• Les entites faibles, dont l'existence depend d'une autre entite. C'est le cas d'une entite 
representant une commande qui depend de 1' entite personne (pas de commande s'il n'y 
a pas de client). 

Les entites sont representees graphiquement par des rectangles (voir figure 13-1). 



personne 



vo itu re 



fact Lire 



I iv re- 



Figure 13-1 

Representation des entites 



Les attributs 



Chaque entite a des caracteristiques particulieres, que Ton retrouve dans toutes ses 
occurrences. Un client a, par exemple, necessairement un nom, un prenom, une adresse, 
etc. Ces caracteristiques sont nominees attributs de 1' entite. 

Chaque entite doit avoir au moins un attribut, qui permet de distinguer une occurrence 
d'une autre. Cet attribut particulier est la cle primaire de l'entite. Cette cle doit etre 
unique dans l'entite. Pour une personne, il est evidemment possible de trouver deux 
personnes de meme nom. Le nom est done un mauvais candidat pour effectuer cette 
distinction. 

Pour distinguer deux clients, on utilise habituellement un numero de client pour chaque 
personne. La cle primaire peut etre constituee de la reunion de plusieurs attributs, par 
exemple, le nom et l'adresse, si nous admettons qu'il n'est pas possible que deux personnes 
homonymes habitent au meme endroit. L'utilisation d'une cle primaire abstraite, comme 
un identifiant numerique (par exemple le numero INSEE propre a chaque personne), 
represente une solution plus sure que le choix d'un autre attribut, et il est conseille de 
l'utiliser systematiquement. 

Un attribut peut etre defini comme obligatoire ou facultatif dans l'entite. II peut etre 
elementaire ou decomposable en plusieurs autres attributs. L'adresse complete d'une 
personne peut constituer un seul attribut ou etre decomposee en rue, ville, departement 
et code postal. II n'y a pas d'obligation en ce domaine. Cela releve d'un choix du pro- 
grammeur en fonction des besoins du client. S'il n' envisage pas de realiser un jour des 
recherches de personnes par ville ou par departement, il est inutile de decomposer 1' attri- 
but adresse. 

Chaque attribut possede un domaine de valeurs possibles. Un nom est represente par une 
chaine de caracteres de longueur variable et le code postal par un nombre de cinq chiffres. 
A chaque attribut correspond un type de donnee particulier. C'est a prendre en compte 
lors de 1' implantation de la base de donnees sur un SGBDR particulier. 
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Une entite munie de ses attributs est representee par un rectangle contenant le nom de 
l'entite suivi de celui de ses attributs. Dans la representation graphique de 1'entite, le nom 
de l'attribut qui constitue la cle primaire est place en premier et souligne (voir figure 13-2). 



personne 



id personne 

nom 

prenom 

adresse 

ville 



Figure 13-2 

Representation graphique d'une entite 



Les associations 



Le concept d' association permet de representer le lien existant entre deux ou plusieurs 
entites. Une association reliant deux entites est dite binaire. Celle qui en relie plusieurs 
est dite re-aire. Dans la decomposition de l'information en entites vous avez toujours inte- 
ret a creer des associations binaires et a redecomposer celles qui seraient ternaires. 

Une association est generalement nommee a l'aide d'un verbe d'action (a la forme active 
d'une entite vers l'autre et passive dans l'autre sens). Par exemple, la phrase « Un client 
commande un article » resume l'association commande entre l'entite cl ient et vers l'entite 
article. Une association est representee graphiquement par une ellipse contenant son 
nom. La figure 13-3 donne la representation graphique de cette association. Une associa- 
tion peut, comme les entites, posseder des attributs. La cle de l'association est la conca- 
tenation des cles des entites qu'elle relie. Une association peut etre reflexive, c'est-a-dire 
relier une entite aelle-meme. Par exemple, l'association conjoint relie une personne avec 
une autre personne. 
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Les cardinalites 



La cardinality d'une association mesure le nombre d'occurrences d'une entite qu'il est 
possible d'associer a une occurrence de l'autre entite associee. Elles sont indiquees de 
chaque cote de l'association pour chaque entite. 
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On distingue des cardinality's minimales et maximales : 

• La cardinality minimale mesure le nombre minimal de participation d'une entite dans 
1' association. Pour etre enregistree dans la base, une personne doit passer au moins 
une commande. La cardinalite minimale du cote de l'entite personne est done 1. Un 
produit peut n'etre commande par aucune personne. La cardinalite minimale du cote 
de l'entite arti cl e est done 0. En resume, on indique ces deux cardinalites par la nota- 
tion O.N. 

• La cardinalite maximale mesure le nombre maximal de participations d'une entite 
dans l'association. Une personne peut passer un nombre quelconque de commandes. 
La cardinalite maximale du cote de l'entite personne est done notee N. Un produit peut 
etre commandee par N personnes differentes. La cardinalite maximale du cote de 
l'entite arti cl e est done N. En resume, on indique ces deux cardinalites par la notation 
N.N. En pratique, on la note N.M pour montrer que les cardinalites ne sont pas neces- 
sairement egales. 

Par combinaison des differentes possibilites, on obtient quatre cardinalites possibles pour 
chaque entite : 

0. 1 : zero ou une seule au maximum ; 

1.1 : une et une seule ; 

O.N : zero ou plusieurs ; 

l.N : une ou plusieurs. 

La figure 13-4 represente l'association commande munie de ses cardinalites. 
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Figure 13-4 

Association et cardinalites 

Une association peut etre definie au moyen des seules cardinalites maximales. L'associa- 
tion de la figure 13-4 peut etre definie par la cardinalite N:M. 

Apres etude des cardinalites, on distingue plusieurs cas, qui vont constituer l'organisation 
des tables dans le modele relationnel. 



Determination des cardinalites 

Vous verrez dans les exemples qui suivent que la determination des cardinalites peut 
dependre des contraintes imposees au programmeur. 
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Exemple 1 

Un ministere comprend plusieurs services. Chaque service est dirige par une seule 
personne. Pour tenir compte des changements de directeur, l'association di ri ge doit avoir 
un attribut date qui contienne la date de nomination. La figure 13-5 donne une represen- 
tation de cette association. 
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Figure 13-5 

Association 1:1 

Une et une seule personne dirige un service, ce qui correspond a une cardinalite 1.1 pour 
l'entite dirigeant. Chaque service est dirige par une et une seule personne, ce qui se 
traduit par une cardinalite 1.1 pour l'entite service. 

Exemple 2 

Reprenons le meme ministere qu'a 1' exemple 1 mais en representant l'association entre 
tous les employes du ministere, quel que soit leur grade ou le service dans lequel ils 
travaillent. Une personne travaille dans un et un seul service. La cardinalite du cote de 
l'entite personne est done 1.1. Un service emploie de une personne a plusieurs personnes. 
La cardinalite du cote de l'entite servi ce est done l.N. 

La figure 13-6 donne une representation de cette association. 
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Figure 13-6 

Association 1:N 



Exemple 3 

Pour suivre revolution des prix, on recense un nombre de produits vendus dans un 
ensemble de magasins. Chaque magasin peut vendre un ou plusieurs produits. La cardi- 
nalite du cote de l'entite magasin est done l.N. Chaque produit peut etre vendu par un ou 
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plusieurs magasins. La cardinality du cote de l'entite produit est done l.N. Chaque maga- 
sin vend le produit a un prix donne. L'association doit done posseder un attribut prix. 

La figure 13-7 donne une representation de cette association. 
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Conception du MCD 

Pour etablir le modele conceptuel de donnees (MCD) correspondant a 1' ensemble 
d' informations a stacker, il faut proceder de la facon suivante : 

1. Decomposer l'information globale en entites independantes representant des concepts 
differents. 

2. Pour chaque entite, faire l'inventaire des attributs qui permettent de la decrire. Le 
degre de precision de cette description depend des besoins du client et de 1' utilisation 
qui sera faite de la base de donnees. Chaque attribut doit etre utile. II faut, par exemple, 
envisager quels seront les criteres de recherche utilises sur la base. Chaque attribut 
doit pouvoir etre exprime clairement par une chaine de caracteres, un nombre ou une 
date, par exemple. 

3. Pour chaque entite, choisir 1' attribut ou le groupe d' attributs qui peut constituer une 
cle primaire, en evitant les cles primaires composites dans la mesure du possible. 
L'utilisation d'une cle primaire numerique est souvent la meilleure solution. 

4. Definir les associations qui relient les differentes entites. II faut privilegier les associa- 
tions binaires, quitte a creer des entites supplementaires. La gestion et 1' interrogation 
de la base s'en trouvent facilitees. 

5. Determiner les attributs de l'association en ne retenant que les attributs vraiment 
necessaires caracterisant l'association. Si un attribut n'est pas necessaire, mieux vaut 
le placer dans une entite. 

6. Exprimer les cardinality's de l'association pour chaque entite qui y est reliee. 



Normalisation du MCD 

Le MCD elabore a l'etape precedente doit etre verifie et normalise au moyen de methodes 
particulieres. 
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numero_cl ient — > Nom_client 
commune — > code postal 



II faut introduire ici la notion de dependance fonctionnelle (DF), proche de la notion 
mathematique de fonction. On dit que deux attributs A et B sont en dependance fonction- 
nelle si, a une valeur de A, correspond, au plus, une valeur de B. 

On a, par exemple, les dependances fonctionnelles suivantes : 

I 

alors que les reciproques ne sont pas vraies. 

Les methodes permettant de verifier et de normaliser le MCD sont les suivantes : 

• Chaque attribut est atomique, c'est-a-dire qu'il ne peut contenir qu'une seule valeur 
choisie dans un domaine particulier. Par exemple, un attribut ne peut contenir 
plusieurs noms de personnes differentes. C'est ce qu'on nomme la premiere forme 
normale (1 N.F) 

• Tous les attributs d'une entite en 1 N.F doivent dependre completement de la cle de 
l'entite et non d'une partie seulement de la cle. C'est la deuxieme forme normale 
(2 N.F). Une entite en 1 N.F qui a une cle primaire composee d'un seul attribut est 
necessairement en 2 N.F. 

• Tous les attributs d'une entite en 2 N.F dependent uniquement de la cle et non d'un 
autre attribut nom-cle. Si ce n'est pas le cas, il faut decomposer l'entite en deux entites 
distinctes, la nouvelle entite contenant les attributs nom-cle qui sont en dependance 
fonctionnelle. C'est la troisieme forme normale (3 N.F). 

• Les attributs d'une association doivent etre en 2 N.F et done dependre de toute la cle 
de l'association (constituee par la concatenation des cles des entites reliees). 

La base magasin en ligne 

Votre objectif premier etant de modeliser la base de donnees d'un site de commerce en 
ligne, vous devez envisager les contraintes d'utilisation de la base qui vous permettront 
de creer son MCD : 

1. Un client enregistre dans la base a passe au moins une commande, sinon il ne figure 
pas dans la base. 

2. Une commande peut contenir un ou plusieurs articles. Chaque commande a une date. 

3. Le modele doit permettre de retrouver toutes les commandes d'un client et la compo- 
sition de chaque commande. 

En fonction de ces contraintes, vous constatez immediatement que le MCD de la 
figure 13-4 ne convient pas. En effet, il ne prend pas en compte le fait qu'un client peut 
commander plusieurs articles (contrainte n° 2). 

Vous devez creer une entite separee pour representer une commande et les associations 
repondant aux besoins suivants : 
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• Un client passe une ou plusieurs commandes. L'association passe relie les entites 
cl ient et commande. Un client passe une ou plusieurs commandes, ce qui implique une 
cardinalite l.N du cote de l'entite cl ient. Une commande est passee par un seul client, 
ce qui implique une cardinalite 1.1 du cote de l'entite commande. 

• Une commande contient un ou plusieurs articles. Vous creez done une association 
contient, qui relie les entites commande et article. La cardinalite du cote de l'entite 
commande est l.N. Un article pouvant se trouver dans aucune ou plusieurs commandes, la 
cardinalite du cote de l'entite arti cl e est O.N. 

Vous obtenez finalement le MCD represente a la figure 13-8. 
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Figure 13-8 

Le MCD de la base magasin 



Passage au modele relationnel 

La phase precedente vous a permis de creer le MCD de la base. C'est la partie la plus 
importante de votre travail. II vous faut maintenant creer le modele logique de donnees 
(MLD), qui permettra 1' implementation physique de la base sur des SGBDR comme 
MySQL ou SQLite. 



Le modele relationnel 

La theorie des SGBDR s'appuie sur les notions mathematiques de la theorie des ensembles 
et des relations entre ensembles. A chaque attribut correspond un ensemble de valeurs 
possibles (parfois tres grand) nomme domaine. 

Supposez, par exemple, que vous deviez etudier les notes attribuees a une classe de 
26 eleves nommes par des lettres de A a Z et qu'il existe, pour simplifier, quatre catego- 
ries de notes de 1 a 4. A la rentree scolaire, oil tous les espoirs sont permis, il y a done 
theoriquement 26 x 4 = 104 associations (couples) possibles entre P ensemble des eleves 
et celui des notes correspondant au produit cartesien des deux ensembles, soit P enumera- 
tion {(A,1),(A,2),(A,3),...(B1,B2),...,(Z,1),(Z,2),(Z,3),(Z,4)}. A la fin de Pannee, quand 
les moyennes annuelles sont faites, il n'y a plus que 26 couples reels representant la 
realite de la classe. Cette realite est representee par une relation entre Pensemble des 
eleves et celui des notes. Dans le cas present, a un eleve ne correspond qu'une note, mais 
a une note correspondent plusieurs eleves. 
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Chaque relation est representee par une table. Vous pouvez comparer aisement une table 
a une feuille de tableur que chacun doit connaitre. Dans une table, on stocke les informa- 
tions representatives d'un type particulier d'objet, reel ou abstrait, comme une personne 
ou une commande. Tous les objets representes dans une meme table doivent representer 
un meme concept. 

La representation des notes de la classe serait done une table a deux colonnes, chaque 
colonne etant un attribut de la table. La premiere contient le nom et la seconde la note de 
Peleve. Elle aurait au total vingt-six lignes. 

La figure 13-9 donne une representation d'une table representant des articles. La premiere 
ligne d'en-tete donne le nom de la table, la deuxieme contient la liste des attributs, et les 
suivantes contiennent les valeurs de plusieurs occurrences, chacune representant un tuple 
(ou rc-uplet). 



article 










■* — 


t4lbif 




idarticle 


designation 


prix 


categorie 








-« — 


attributes 


515 


PC de bureau 


958.35 


Informatique 










lupk 




535 


Appareil photo 


253.58 


Photo 








647 


Portable HB 25 


1547.00 


Informatique 





Figure 13-9 

Representation d'une table 



Conception du MLD 

Pour passer du MCD au MLD, il vous faut appliquer les regies suivantes : 

1. Toute entite devient une table, avec pour corollaires que la table porte le nom de 
l'entite, que les attributs de 1' entite deviennent les colonnes de la table et que la cle 
primaire de l'entite devient la cle de la table. 

2. Pour une association binaire ayant des cardinality's maximales 1:1 (par exemple 1.1- 
1.1), une des tables recoit comme attribut supplementaire une copie de la cle primaire 
de P autre table. Cet attribut devient une cle etrangere pour la table qui la recoit. Les 
attributs eventuels de P association sont reportes dans cette meme table. Au MCD 
presente a la figure 13-5 correspond le MLD de la figure 13-10 pour Passociation 
di rige. 

Si vous voulez par exemple conserver Phistorique des differents responsables d'un 
service, vous devez creer une nouvelle table representant Passociation. Elle contient 
les cles des deux entites reliees, et la concatenation des ces cles en constitue la cle 
primaire. Cette table contient egalement P attribut de Passociation. 
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Figure 13-10 

MLD d'une association 1:1 

3. Pour une association binaire ayant des cardinalites maximales de type 1 :N, par exem- 
ple, 1.1-l.N ou 0.1-0.N, la table representant l'entite ayant la cardinality 1.1 recoit la 
cle de l'autre entite comme cle etrangere. Les attributs de l'association sont ajoutes a 
cette meme table. Le MCD de la figure 13-6 devient le MLD presente a la figure 13-11 
pour les employes d'un service. 
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Figure 13-11 

MLD d'une association 1:N 

4. Pour une association binaire ayant des cardinalites maximales de type N:M, par 
exemple, l.N-l.N ou 0.N-1.N, l'association est toujours traduite par une table. La cle 
primaire de cette table est la concatenation des cles primaires des entites reliees par 
cette association. Les attributs de l'association sont ajoutes a cette nouvelle table. Le 
MCD de la figure 13-7 correspond au MLD de la figure 13-12. II s'agit d'un MCD 
primaire, car il suppose qu'une personne ne peut commander qu'un article par 
commande et une seule fois le meme article, faute de quoi vous seriez en infraction 
avec les regies definies (a une meme cle primaire correspondrait deux dates diffe- 
rentes). 
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MLD d'une association N:M 
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Association reflexive 

Si I'association est reflexive, elle devient une table dont la cle est la concatenation des cles des deux 
elements associes. Ce serait le cas de I'association conjointe envisagee plus haut. 



Le MLD de la base magasin en ligne 

En appliquant les regies enoncees precede mment, le MLD de la base magasin du site 
de commerce en ligne est construit a partir du MCD represents a la figure 13-8 de la 
maniere suivante : 

• Les entites client, commande et article deviennent des tables. 

• L'association passe qui relie les entites cl ient et commande ne devient pas une table. La 
cle primaire de la table commande recoit la cle primaire de la table client comme cle 
etrangere. 

• L'association contient, dont les cardinality's maximales sont de type N:M, devient une 
table nominee 1 igne, dont chaque occurrence represente une ligne d'une commande. La 
cle primaire de cette table est la concatenation des cles id_comm de la table commande et 
idjrticle de la table article. Elle recoit les attributs quantite et prix_unit. 



L'attribut prix_unit 

L'attribut prix_uni t n'existe que pour permettre de retrouver la realite d'une commande ancienne, meme 
apres modification d'un tarif dans la table article. 



La figure 13-13 presente le MLD obtenu. 
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Figure 13-13 

MLD de la base magasin en ligne 



Modele physique de donnees 

Le modele physique de donnees est 1' implementation materielle du MLD cree sur un 
systeme (SGBDR) donne. II est realise a l'aide du langage SQL (Structured Query 
Language) et des particularites de chaque systeme, tel que MySQL, SQLite ou Microsoft 
Access. L'apprentissage du langage SQL specifiquement oriente vers MySQL fait l'objet 
du chapitre suivant. 
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Exercices 



Exercice 1 

Creez le MCD d'une base de donnees voiture qui enregistre les certificats d'immatricu- 
lation des vehicules en circulation (carte grise). Elle doit repondre aux contraintes 
suivantes : 

• Un vehicule est d'un modele donne identifie par un numero de type. 

• Un vehicule peut avoir un ou plusieurs proprietaires simultanement (copropriete). 

• Les recherches effectuees sur la base doivent permettre de retrouver, par exemple, tous 
les vehicules d'une personne, la ou les personnes proprietaires d'un vehicule dont on 
connait rimmatriculation et tous les proprietaires d'un modele de voiture donne. 

Exercice 2 

Creez le MLD de la base voiture a partir du MCD de l'exercice 1. Verifiez la conformite 
du modele par rapport aux formes normales. 

Exercice 3 

Creez le MCD d'une base de donnees tournoi permettant d'enregistrer les participants a 
un tournoi de tennis et l'ensemble des matches joues en trois sets au maximum. La base 
doit enregistrer les participants d'un match donne, ainsi que le gagnant et le score de 
chaque set. 

Exercice 4 

Creez le MLD de la base tournoi , et verifiez sa conformite. 

Exercice 5 

Creez le MCD d'une base permettant a un groupe de gerer les droits d'auteur des livres 
publies par ses differentes maisons d' edition. Elle doit repondre aux contraintes suivantes : 

• Un livre peut etre ecrit par un ou plusieurs auteurs. Un auteur peut ecrire un ou 
plusieurs livres. Chaque auteur touche un pourcentage des droits totaux d'un livre en 
fonction de sa participation. 

• Un livre est publie par un seul editeur. 

Exercice 6 

Creez le MLD correspondant a la base de l'exercice 5, et verifiez sa conformite. 
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Le langage SQL 
et phpMyAdmin 



Cree par IBM il y a plus de trente cinq ans en tant que langage de manipulation de 
donnees, le SQL (Structured Query Language) est aujourd'hui le standard de la plupart 
des SGBDR, notamment de MySQL et de SQLite, presentes en detail dans cet ouvrage. 
Ce langage a fait l'objet de normalisations successives de la part de l'ANSI (American 
National Standards Institute) pour aboutir en 1992 a SQL 2 puis en 1999 a SQL 3 et 
enfin a SQL 2003, ce qui montre une constante evolution afin de s' adapter aux besoins. 

Malgre cet effort de standardisation, chaque SGBD adapte le langage SQL, en n'utilisant 
que certaines fonctionnalites et en en ajoutant d'autres, non standards. Si vous avez deja 
une connaissance de SQL acquise pour un autre systeme que MySQL vous ne serez pas 
desorientes. II vous faudra simplement effectuer quelques adaptations non fondamen- 
tales. Toutes les commandes utilisees dans ce chapitre sont celles de MySQL. 



L'interface phpMyAdmin 

Meme si le couple PHP- MySQL est le plus repandu actuellement sur le Web, MySQL est 
accessible a d'autres langages, notamment Java. La totalite des hebergements PHP- 
MySQL offrent une interface nominee phpMyAdmin, a partir de laquelle il est possible, 
pour l'administrateur seulement, d'effectuer toutes les operations de creation de base et de 
tables, d'insertion ainsi que de selection de donnees. L'interface phpMyAdmin installee 
sur vos serveurs local et distant est en realite un formulaire ecrit en PHP permettant 
d'agir sur la base. 
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L'interface phpMy Admin vous permet d'envoyer au serveur des requetes SQL de crea- 
tion et d' administration de base sans avoir a les ecrire. L'interface affiche de surcroit le 
code SQL de la requete qui vient d'etre executee. 

Pour y acceder a partir d'un navigateur, il vous suffit de saisir les adresses suivantes : 

en local : 

http://localhost/phpmyadmin 
ou : 

http://127.0.0.1/phpmyadmin 
pour des serveurs distants : 

http://sql .votresite.com 
ou 

http://www.votresite.com/phpmyadmin 
ou encore parfois : 

http://www.votresite.com/phpMyAdmin 

selon la sensibilite a la casse de votre serveur et la casse employee pour le repertoire 
correspondant. 

Les options d'acces sont communiquees par l'hebergeur lors de la souscription d'un 
abonnement. 

En local, vous obtenez la page d'accueil illustree a la figure 14-1. La version actuelle de 
phpMy Admin fournie sur le serveur local installe avec Wampserver etant la 2.1 1.6, c'est 
avec cette version que vous allez travailler. Pour une version differente, certaines actions 
doivent etre adaptees en saisissant les requetes SQL correspondantes. 

Certains hebergeurs, tel ovh.net, autorisent l'acces au repertoire contenant le code de 
phpMy Admin. II est de la sorte possible d' installer la derniere version en la telechargeant 
a l'adresse http://www.phpmyadmin.net/home_page/index.php. 

Les sections qui suivent expliquent comment creer une base de donnees a l'aide de 
phpMy Admin et detaillent les tables qui la composent, ainsi que les commandes permet- 
tant d'y inserer des informations, de les modifier ou de les mettre a jour et d'effectuer les 
differentes formes de selection de donnees destinees a la creation de pages Web dynami- 
ques. Vous verrez, dans les chapitres suivants, comment interfacer PHP et MySQL au 
moyen des fonctions specialisees ou d'objets et methodes disponibles dans les differents 
modules specialises fournis par PHP. 



Le langage SQL et phpMyAdmin 
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Figure 14-1 

Page d'accueil de phpMyAdmin 



Creation dune base de donnees 

De nombreux hebergeurs, qu'ils soient gratuits ou payants, n'offrent la possibilite de 
creer qu'une seule base de donnees sur leur serveur. Vous verrez cependant qu'il est 
possible de creer en local plusieurs bases differentes. 

Pour attribuer un nom a une base, il faut respecter les conventions suivantes, lesquelles 
s'appliquent egalement aux noms des tables, attributs (colonnes), index et alias utilises : 

• Les caracteres autorises sont les caracteres alphanumeriques et de soulignement (_) 
ainsi que le signe dollar ($). 



Slash et antislash 






Pour eviter de confondre ces noms avec les noms des variables PHP utilisees dans 


un meme 


code, il est 


deconseille d'utiliser les caracteres slash (/), antislash (\) et le point. 
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• Le nombre de caracteres est limits a 64, extensible a 255 pour les noms d' alias. Plus le 
nom est long, plus il y a de risque d'erreur en le recopiant. 

• Un nom peut commencer par un chiffre mais ne doit pas contenir que des chiffres. 

• La sensibilite a la casse depend du systeme d' exploitation. Autant considerer que 
MySQL est sensible a la casse et surtout eviter de changer de casse dans une meme 
requete, notamment pour les noms d' alias de table. 

Pour creer la base, il suffit de saisir le nom de la base desiree (ici magasi n) dans la zone de 
saisie de la page d'accueil de phpMy Admin et de cliquer sur le bouton Creer (voir 
repere O de la figure 14-1) en precisant les jeux de caracteres a utiliser pour la 
connexion (repere ©) et les donnees (repere ©). Une fois la base creee, son nom appa- 
raitra dans la partie gauche de l'interface (repere 0). 

Comme explique precedemment, phpMy Admin genere automatiquement le code SQL 
de Taction effectuee. Apres avoir clique sur le bouton de creation, une nouvelle page 
semblable a celle illustree a la figure 14-2 s'affiche, confirmant la creation de la base 
(repere Q) et affiche le code de la requete SQL suivante (repere ©) : 

CREATE DATABASE magasin DEFAULT CHARACTER SET latinl COLLATE latinl_bin; 



Delimitation des noms 

phpMyAdmin ajoute systematiquement le caractere ' dans le code SQL genere de fagon a delimiter les 
noms des bases, tables et colonnes. Cela n'est toutefois guere utile dans la mesure ou les noms utilises 
pour les bases, tables et colonnes ne risquent pas d'etre des mots reserves par MySQL. 



En ajoutant l'option I F NOT EXISTS avant le nom de la base, cette derniere n'est creee que 
si elle n'existe pas deja. Cela evite les messages d'erreur, surtout si la requete est envoyee 
par un script PHP. 

Avec cette option, la requete precedente devient : 

I CREATE DATABASE IF NOT EXISTS magasin DEFAULT CHARACTER SET latinl 
^COLLATE latinl_bin; 

Pour detruire la base, il suffit de la selectionner puis de cliquer sur le bouton "Supprimer" 
(voir repere © de la figure 14-2). Le code SQL correspondant s'affiche : 

DROP DATABASE magasin; 

Comme precedemment, l'usage de l'option IF EXISTS avant le nom de la base empeche 
1' apparition d'une erreur si vous tentez de supprimer une base qui n'existe pas. 

Avec cette option, la requete devient : 

DROP DATABASE IF EXISTS magasin 

Avant d'effectuer d'autres operations, il vous faut selectionner la base sur laquelle vous 
voulez travailler. 
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Figure 14-2 

La page de confirmation de creation de la base 



Destruction 




La destruction d'une base entraine aussi celle de toutes les tables et de toutes les donnees 


qu'elle 


contient. II convient done d'etre prudent avant d'utiliser cette requete. 





Creation de tables 

Une table est composee de colonnes, ou champs. Chacune de ces colonnes est dote d'un 
type particulier, cense correspondre le mieux possible a l'information qu'elle contient. 
Avant de creer une table, il importe de connaitre les differents types de donnees proposes 
par MySQL. Le choix judicieux de ce type reduit l'espace disque utilise. 

Cette section presente les differents types de donnees reconnus par MySQL ainsi que les 
commandes SQL utilisables pour creer les tables. MySQL permet de creer des tables de 
types differents, en particulier MylSAM et InnoDB. InnoDB est d'ailleurs maintenant le 
type propose par defaut par phpMyAdmin et e'est celui que nous utiliserons car il offre 
plus de possibilites, comme les contraintes de cles etrangeres et les triggers. 
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Les types de donnees MySQL 

MySQL permet de stacker des informations selon de nombreux types de donnees. Cela 
donne la possibilite d' adapter le plus precisement possible le type de donnee a 1' informa- 
tion qui est enregistree dans une table. Le choix du type doit se faire de telle sorte que 
l'information occupe le moins d'octets possible. 

Les types numeriques 

Les types numeriques permettent de stocker toutes sortes de valeurs numeriques entieres 
ou decimales avec des intervalles de valeurs tres etendus. Comme explique precedem- 
ment, il est important d' adapter le type choisi au format de l'information stockee afin de 
ne pas occuper plus d'espace serveur que necessaire et, par voie de consequence, de ne 
pas allonger inutilement les temps de reponse des recherches effectuees. 

Le tableau 14-1 presente les differents types de donnees numeriques. 
Tableau 14-1 - Les types de donnees numeriques 



Type 


Definition et caracteristiques 


TINYINT 


Un tres petit entier prenant des valeurs de -128 (-2 7 ) a 127 (2 7 - 1). S'il 
est suivi de I'option UNSIGNED, les valeurs sont positives et varient de a 
255 (2 s - 1). Chaque valeur occupe 1 octet. 


SMALLINT 


Un petit entier prenant des valeurs de -32758 (- 2 15 ) a 32767 (2 15 - 1 ). S'il 
est suivi de I'option UNSIGNED, les valeurs sont positives et varient de a 
65535 (2 16 - 1). Chaque valeur occupe 2 octets. 


MEDIUMINT 


Entier moyen prenant des valeurs de -8388608 (- 2 23 ) a 8388607 (2 23 - 1 ). 
S'il est suivi de I'option UNSIGNED, les valeurs sont positives et varient de 
a 16777215 (2 24 - 1). Chaque valeur occupe 3 octets. 


INTou INTEGER 


Entier prenant des valeurs de -2147483648 (-2 31 ) a 2147483647 
(2 31 - 1). S'il est suivi de I'option UNSIGNED, les valeurs sont positives et 
varient de a 4294967295 soit 2 32 - 1 . Chaque valeur occupe 4 octets. 



ilGINT 



FLOAT 



DOUBLE 



Grand entier prenant des valeurs de -9223372036854775808 (-2 63 ) a 
9223372036854775807 (2 63 -1). S'il est suivi de I'option UNSIGNED, les 
valeurs sont positives et varient de a 18446744073709551615, soit 
2 64 - 1 . Chaque valeur occupe 8 octets. 

Nombre a virgule flottante en simple precision prenant des valeurs de 
-3.402823466E+38 a -1. 75494351 E-38 pour les nombres negatifs et de 
1.75494351E-38 a 3.402823466E+38 pour les positifs. S'il est suivi de 
I'option UNSIGNED, les valeurs sont uniquement positives. Avec les options 
FLOAT (M.D), I'affichage s'effectue avec M chiffres dont D decimales. 
Chaque valeur occupe 4 octets. 

Nombre a virgule flottante en double precision prenant des valeurs 
de -1.7976931348623157E+308 a "2. 2250738585072014E - 308 
pour les nombres negatifs et de 2.2250738585072014E-308 a 
1 . 7976931348623157E+308 pour les positifs, auxquelles s'ajoute la valeur 
exacte de 0. S'il est suivi de I'option UNS I GNED, les valeurs sont uniquement 
positives. Avec les options DOUBLE (M.D) I'affichage se fait avec M chiffres 
dont D decimales. Chaque valeur occupe huit octets. 
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Tableau 14-1 - Les types de donnees numeriques (suite) 



Type 

DECIMAL 



Definition et caracteristiques 

Nombre a virgule flottante qui doit etre signe. La valeur est stockee comme 
une chaine de caracteres dont chaque caractere est un chiffre. Les valeurs 
sont les memes que pour le type DOUBLE. S'il est suivi de I'option UNSI- 
GNED, les valeurs sont uniquement positives. Avec les options DECIMAL 
(M), I'affichage s'effectue avec M chiffres (par defaut 10 chiffres), ce qui 
limite I'intervalle de valeurs. Avec les options DECIMAL (M,D), I'affichage 
s'effectue avec M chiffres dont D decimales. Chaque valeur occupe autant 
d'octets qu'il y a de caracteres dans le nombre. 



Les types chaTnes de caracteres 

Ces types permettent de stacker des chaines de caracteres de longueurs tres diverses, 
allant du simple caractere au discours fleuve d'un visiteur prolixe dans un livre d'or. A 
nouveau, il vous faut penser a adapter le type de donnee a ce que vous desirez stocker 
afin d'utiliser le moins d'octet possible. 

Le tableau 14-2 presente les differents types de donnees chaines de caracteres. 



Type 

CHAR(M) 



Tableau 1 4-2 - Les types chaTnes de caracteres 
Definition et caracteristiques 



VARCHAR(M) 



Chaine de caracteres de longueur fixe de M caracteres completee par des 
espaces si la donnee stockee est plus petite. Les espaces sont supprimees 
lors de la lecture. La longueur indiquee varie de a 255 caracteres. 
L'option CHAR(M) BINARY rend la chaine sensible a la casse lors des 
recherches. Une colonne de type CHAR(O) n'occupe qu'un octet et peut 
contenir les valeurs NULL et "" (chaine vide), cequi permetdesimulerune 
valeur booleenne. La chaine stockee occupe toujours M octets, meme si 
elle ne contient qu'un seul caractere significatif. 

Chaine de caracteres de longueur variable comprise entre 1 et M carac- 
teres. La valeur de M varie de 1 a 255 caracteres. L'option VARCHAR(M) 
BINARY rend la chaine sensible a la casse lors des recherches. La chaine 
stockee occupe N + 1 octets quand elle comprend N caracteres. 



TINYTEXT 


Texte d'une longueur comprise entre 1 et 255 caracteres. Le type TINY- 


TINYBLOB 


BLOB est sensible a la casse. La chaine stockee occupe W + 1 octets quand 




elle comprend N caracteres. 


TEXT 


Texte d'une longueur comprise entre 1 et 65 535 caracteres. Le type BLOB 


BLOB 


est sensible a la casse. La chaine stockee occupe W + 2 octets quand elle 




comprend N caracteres. 


MEDIUMTEXT 


Texte d'une longueur comprise entre 1 et 16 777 215 caracteres. Le type 


MEDIUMBLOB 


MEDIUMBLOB est sensible a la casse. La chaine stockee occupe W + 3 




octets quand elle comprend N caracteres. 


LONGTEXT 


Texte d'une longueur comprise entre 1 et 4 294 967 295 caracteres. Le 


L0NGBL0B 


type L0NGBL0B est sensible a la casse. La chaine stockee occupe N + 4 




octets quand elle comprend N caracteres. 
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Type 

ENUMCchainel' 
chaineN' ) 



SET( 'chainel' 
'chaineN' ) 



Tableau 14-2 - Les types chaines de caracteres (suite) 

Definition et caracteristiques 

.... Permet le choix d'une seule valeur parmi Enumeration des N chaines de 

caracteres definies dans le type. La valeur NULL est toujours admise, 
meme si elle ne figure pas dans la liste. Le type peut definir jusqu'a 
65 535 valeurs. A chaque chaine correspond une valeur numerique de 1 a 
65 535, correspondant a son ordre d'apparition dans la definition du type. 
La valeur correspond a une chaine vide. La definition deENUM ('bleu', 
'blanc' , 'rouge' ) pour une colonne ne permet de stacker qu'une valeur 
parmi les trois couleurs de la liste ou la valeur NULL. Pourle HTML, ce type 
correspond a une liste de selection <select> de N+l <option> (les N 
valeurs proposees plus le choix NULL par defaut) a choix unique. 

Permet le choix de une ou plusieurs valeurs simultanement parmi I'ensem- 
ble des N chaines de caracteres definies dans le type. L'ensemble peut 
contenir jusqu'a 64 valeurs. A chaque choix correspond une valeur nume- 
rique entiere egale a 2" _1 si n est la position de la chaine dans l'ensemble 
(soit 1 pour la premiere, 2 pour la deuxieme, 4 pour la troisieme, etc.) ou 
encore une valeur binaire dans laquelle chaque bit est a 1 si la valeur est 
choisie (soit 0001 pour la premiere, 0010 pour la deuxieme, 0100 pour la 
troisieme, etc.). Si plusieurs valeurs sont choisies, la valeur numerique 
correspondante est la somme des valeurs de chacune (par exemple 5 pour 
la premiere et la troisieme valeur). En HTML, ce type correspond a une liste 
de selection <select> de N <option> a choix multiple (avec I'attribut 
multiple). 



Les types de dates et d'heures 

Les types de dates et d'heures permettent de stacker des dates dans des formats diffe- 
rents, allant de la simple annee seule a l'ensemble date complete plus heure complete a la 
seconde pres. 

Pour stacker un timestamp UNIX tel que detaille au chapitre 8, il est preferable d'utiliser 
une colonne de type entier INT(IO), qui facilite les operations. 

Le tableau 14-3 presente les differents types de donnees de dates et d'heures. 



Tableau 14-3 - Les types de dates et d'heures 



Type 


Definition et caracteristiques 


DATE 


Une date au format AAAA-MM-JJ dans I'intervalle de 1000-01-01 a 9999- 
12-31. Chaque enregistrement occupe 3 octets. 


DATETIME 


Contient la date et I'heure au format AAAA-MM-JJ HH:MM:SS dans I'inter- 
valle de 1000-01-01 00:00:00 a 9999-12-31 23:59:59. Chaque enre- 
gistrement occupe 8 octets. 


TIMESTAMP[(M)] 


Stocke une date complete sous la forme AAAAMMJJHHMMSS sans rapport 
direct avec un timestamp UNIX tel que retourne par la fonction timeO 
detaillee au chapitre 8. 
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Tableau 14-3 - Les types de dates et d'heures (suite) 

II faut toutefois prendre des precautions pour effectuer des calculs avec ce 

type devaleur. En effet, lecalcul 20030506232009 + 1030 n'ajoute pas 

1 030 secondes mais 10 minutes et 30 secondes. De plus, I'addition peut 

conduire a des dates invalides par depassement des valeurs admises 

(25 heures, par exemple). Le parametre M facultatif determine le nombre 

de caracteres utilise pour afficher la date. Ce doit etre un nombre pair. Sa 

valeur par defaut est 14. 

En fonction de la valeur de M, vous obtenez les formats d'affichage 

suivants : 

TIMESTAMPU4) AAAAMMJJHHMMSS 

TIMESTAMPU2) AAMMJJHHMMSS 

TIMESTAMPU0) AAMMJJHHMM 

TIMESTAMP(8) AAAAMMJJ 

TIMESTAMP(6) AAMMJJ 

TIMESTAMP(4) AAMM 

TIMESTAMP(2) AA 

Chaque enregistrement occupe quatre octets. 

TIME Stocke I'heure au format HH:MM:SS ou HHH:MM:SS pour un intervalle de 

valeurs allant de -838:59:59 a 838:59:59 permettant d'effectuer des 
calculs de duree excedant 24 heures. Chaque enregistrement occupe 
3 octets. 

YEAR Represente les annees au format YYYY pour un intervalle allant de 1901 a 

2155. Si I'annee est fournie avec deux chiffres, les valeurs de 00 a 69 
correspondent aux annees 2000 a 2069 et les valeurs 70 a 99 aux annees 
1970 a 1999. Chaque enregistrement occupe 1 octet. 



Les options des attributs 

Chaque attribut d'une table peut etre precise a l'aide des options suivantes : 

• NOT NULL pour que chaque enregistrement de l'attribut ait obligatoirement une valeur 
ou NULL pour autoriser l'absence de valeur (cette derniere option est interdite pour une 
cle primaire). Nous ecrivons, par exemple : 

nom_attr VARCHAR(IO) NOT NULL 

• DEFAULT ' valeur_defaut' permet de definir une valeur par defaut pour l'attribut si 
aucune valeur n'y est enregistree. Cette option est impossible pour les types BLOB et 
TEXT. Les valeurs par defaut doivent etre des constantes, et il n'est pas possible d'utili- 
ser de fonction pour les definir. 

• AUTO^INCREMENT pour qu'un attribut numerique entier soit automatiquement incremente 
d'une unite a chaque insertion d'un enregistrement. Pour que cette contrainte soit vala- 
ble, il faut que l'attribut soit indexe ou qu'il soit la cle primaire. Par exemple, le code 
suivant : 

nom tinyint NOT NULL auto_increment, INDEX indnom (nom) 

cree un attribut nom auto-incremente NOT NULL et indexe sous le nom indnom. 
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• PRIMARY KEY pour definir l'attribut comme cle primaire de la table. II est recommande 
de faire cette declaration apres la definition de tous les attributs. Par exemple, le code 
suivant : 

| nom tinyint(4) NOT NULL AUTO_INCREMENT, PRIMARY KEY (nom) 

definit un attribut nom et une cle primaire sur un attribut. 

Le code suivant : 

PRIMARY KEY (nom, prenom) 

cree une cle primaire composee des deux attributs, nom et prenom. 

De meme, pour definir le ou les index de la table, vous devez faire figurer les contraintes 
suivantes apres les definitions d' attributs : 

• UNIQUE(nom_attributl,nom_attribut2 ) pour que chaque enregistrement ait une 

valeur unique dans la colonne des attributs precises. Par exemple, le code suivant : 

UNIQUEtnom, prenom) 

empeche d'enregistrer deux personnes ayant le meme nom et le meme prenom. Par 
contre, deux noms identiques avec deux prenoms differents sont acceptes. 

• INDEX[nom_index] (nom_attributl ,nom_attribut2 ) cree un index pour la table a 

partir des colonnes precisees. La creation d'index sur des colonnes de la table facilite 
les recherches quand ces colonnes sont utilisees comme critere de recherche. Par 
exemple, le code suivant : 

INDEX mon_index (nom, prenom) 

cree un index nomme mon_i ndex sur les colonnes nom et prenom. 

Creation des tables 

Vous allez maintenant creer les tables destinees a contenir les donnees. Les sections qui 
suivent detaillent les quatre tables a creer pour la base magasi n, les tables cl i ent, commande, 
article et ligne. La figure 14-3 rappelle le MLD de la base magasin qui vanous permet- 
tre de creer les differentes tables qui la composent. 



Figure 14-3 

Le MLD de la base magasin 
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La table client 

Le code suivant definit les colonnes de la table cl ient. 

cl ient(id_cl ient, nom, prenom, age, adresse, ville, mail) 

La colonne id_cl ient est de type MEDIUMINT, avec l'option UNSIGNED selectionnee. Sa valeur 
est done un entier positif, avec 16 777 215 clients possibles. Cet attribut etant la cle 
primaire de la table, choisissez dans phpMyAdmin les options PRIMARY KEY (bouton radio 
dans la colonne Primai re de la figure 14-5) et NOT NULL car le champ id_cl ient doit avoir 
obligatoirement une valeur (colonne Nul 1 de la figure 14-5). Ce champ etant incremente 
automatiquement d'une unite a chaque nouvelle insertion de donnee, il a egalement 
l'option AUTO_INCREMENT choisie dans la colonne Extra de la figure 14-5. 

Les colonnes nom, prenom, adresse et ville sont des chaines de caracteres de longueur 
variable, done de type VARCHAR, avec l'option NOT NULL selectionnee. 

La colonne age est un entier positif de petite taille, done de type TINYINT UNSIGNED. 
L'intervalle des valeurs est de a 255. L'option NULL permet a un client de ne pas saisir 
son age. 

La colonne mail est egalement de type VARCHAR, mais cette fois avec l'option NULL selec- 
tionnee, car un client peut ne pas donner son adresse e-mail. 

La table commande 

La table commande a la structure suivante : 

commande (id_comm, id_client, date) 

La colonne id^comm est de type MEDIUMINT, avec les options UNSIGNED, NOT NULL et AUT0_ 
INCREMENT selectionnees, de facon que chaque commande ait un numero different. 

La colonne id_client est une cle etrangere issue de la table client. Elle a les memes 
caracteristiques que i d_comm. La cle primaire de la table est composee des champs i d_comm 
et id_cl ient. 

La colonne date est de type DATE, avec l'option NOT NULL selectionnee, de facon que les 
valeurs soient inserees automatiquement sans intervention du client et qu'il n'y ait pas a 
craindre un oubli. 

La table article 

La table arti cl e a la structure suivante : 

article(id_article, designation, prix, categorie) 

La colonne idjrticle correspond au code de chaque article sur cinq caracteres. Elle est 
done de type CHAR(5), avec les options NOT NULL et PRIMARY KEY selectionnees. 

La colonne designation est de type VARCHAR(IOO), avec l'option NOT NULL selectionnee. 
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La colonne prix est de type DECIMAL(8,2). Elle est done sur huit chiffres, dont deux deci- 
males, avec l'option NOT NULL selectionnee. 

La colonne categorie est de type ENUM. Elle comporte une liste de cinq valeurs possibles 

('tous', 'video', 'photo', ' informatique' , 'divers ') avec l'option NOT NULL selection- 
nee et la valeur par defaut ' tous ' . 

La table ligne 

La table 1 i gne a la structure suivante : 

1 i gne ( i d_comm, id_arti cle, quant ite) 

La colonne id_comm est une cle etrangere issue de la table commande et la colonne id_ 
article une cle etrangere issue de la table article, ces colonnes doivent done etre decla- 
rers avec les memes types de donnees que celles auxquelles elles se referent dans les 
tables commande et article. La colonne quantite est un petit entier de type TINY I NT, avec les 
options UNSIGNED et NOT NULL selectionnees. L'intervalle de valeurs est de 1 a 255. La cle 
primaire de la table est composee des attributs id_comm et id_articl e. 



Hierarchie base. table. colonne 

II est possible que plusieurs bases aient des tables de meme nom et que des tables differentes aient des 
colonnes de meme nom. Pour acceder sans ambigu'ite a une colonne precise il faut employer la syntaxe 
suivante : nom_base.nom_table.nom_colonne 



En resume 

Pour creer une table, par exemple la table cl ient, procedez de la facon suivante : 

1. Selectionnez la base dans la page d'accueil de phpMy Admin. 

2. Saisissez un nom pour la table et le nombre de champs qui la composent dans les 
zones de saisie illustrees aux reperes Q et © de la figure 14-4. 

3. Cliquez sur le bouton Executer. 
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Figure 14-4 

Creation d'une table avec phpMyAdmin 
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Precision 

Dans un premier temps, les champs ville et age ont ete volontairement oublies afin d'illustrer a la 
section suivante les possibilites de modification des tables offertes par phpMyAdmin. 



4. Dans la page qui s'affiche, saisissez les caracteristiques des colonnes, ou champs, de 
la table dans un formulaire comptant autant de lignes qu'il y a de champs definis 
(voir la figure 14-5). 
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Figure 14-5 

Creation de la table client 



Le code genere par phpMyAdmin est le suivant : 

CREATE TABLE 'magasin' . 'cl ient' ( 

'id_client' MEDIUMINT UNSIGNED NOT NULL AUTO_INCREMENT , 

'nom' VARCHAR( 30 ) NOT NULL , 

'prenom' VARCHARt 30 ) NOT NULL , 

'adresse' VARCHAR( 60 ) NOT NULL , 

'mail' VARCHAR( 50 ) NULL DEFAULT 'pas de mail', 

PRIMARY KEY ( 'id_client' ) 

) ENGINE = InnoDB 

Ce code affiche un tableau contenant la structure resumee de la table, comme illustre a la 
figure 14-6. 
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Figure 14-6 

Structure de la table client 
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Vous pouvez creer de la meme facon les autres tables de la base magasin en prenant soin 
de respecter les definitions donnees precedemment. 

Pour chacune de ces tables, le code de creation est le suivant : 

• table comma nde : 

CREATE TABLE "commande" ( 

"id_comm" mediumint( 8 ) unsigned NOT NULL AUTCLINCREMENT , 

"id_client~ mediumint( 8 ) unsigned NOT NULL , 

"date* date NOT NULL , 

PRIMARY KEY ( "id_comm" , "id_client" ) , 

INDEX "id_client" ( "id_client" ) 

) ENGINE = InnoDB DEFAULT CHARSET = latinl COLLATE = latinl.bin AUTO_INCREMENT = 1 

table article : 

CREATE TABLE "magasin". "article* ( 
"id_article" CHAR( 5 ) NOT NULL , 
"designation" VARCHAR( 100 ) NOT NULL , 



'video', 'informatique' , 'divers' 



"prix" DECIMALC 8, 2 ) NOT NULL , 

"categorie" ENUM( 'tous', 'photo' 

DEFAULT 'tous', 

PRIMARY KEY ( "nd_article~ ) 

) ENGINE = InnoDB CHARACTER SET latinl COLLATE latinl_bin 



NOT NULL 



table 



i gne 



CREATE TABLE "magasin" . "1 igne" ( 

"id_comm" MEDIUMINT UNSIGNED NOT NULL AUTO_INCREMENT , 

"id_article" CHAR( 5 ) NOT NULL , 

"quantite" TINYINT UNSIGNED NOT NULL , 

"prix_unit" DECIMALC 8, 2 ) NOT NULL , 

PRIMARY KEY ( "id_comm" , "id_article" ) 

) ENGINE = InnoDB 

La syntaxe simplifiee de la commande CREATE TABLE est la suivante : 

CREATE [TEMPORARY] TABLE [IF NOT EXISTS] nonstable ( 
nom_colonnel N0M_TYPE [options], 
nom_colonne2 N0M_TYPE [options], 
FOREIGN KEY (nom_colonne, . . . ) 
) 

Le mot-cle TEMPORARY indique que la table n'est creee que le temps de la connexion a la 
base et qu'elle est ensuite effacee. 

Le mot-cle I F NOT EXISTS permet de ne creer la table que si une autre table du meme nom 
n'existe pas deja. En 1' absence de cette precision, une erreur se produit si une telle table 
existe deja. 
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Modification des tables 



Apres sa creation, une table n'est pas figee. Elle peut evoluer en fonction des besoins, 
soit pour ajouter ou oter des attributs, soit pour modifier ou ajouter des contraintes, des 
index, par exemple, soit encore pour supprimer toute la table. 

Ajout d'un champ 

Comme explique precedemment, vous avez volontairement oublie deux champs de la 
table client pour illustrer les possibilites de modification offertes par phpMyAdmin. 
Vous allez maintenant ajouter ces champs, vi 11 e et age. 

Pour ajouter un champ, il suffit, apres avoir choisi la table desiree, de saisir le nombre 
de champs et leur position dans la table, comme l'illustre la figure 14-7 pour l'ajout du 
champ ville apres l'adresse. L'ordre des champs n'a pas d' importance pour le stockage 
des donnees mais releve plutot d'une convention personnelle de presentation. 

• Ajouter un champ : fl | Apres adressQ v| [ Fnprntpr | I 

Figure 14-7 

Ajout du champ ville a la table client 

Le code genere est le suivant : 

ALTER TABLE client ADD ville VARCHAR( 40 ) NOT NULL AFTER adresse ; 
Ajoutez de la meme facon le champ age apres le champ prenom. 
Le code genere est le suivant : 

ALTER TABLE 'client' ADD 'age' TINYINT UNSIGNED AFTER 'prenom' ; 

Pour obtenir automatiquement la structure finale de la table apres execution de la modifi- 
cation ou a tout moment, il suffit de cliquer sur le bouton Structure (voir figure 14-8). 
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Figure 14-8 

Structure finale de la table client 
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Vous pouvez verifier qu'elle repond bien a la definition qui en a ete donnee lors de sa 
conception. 

Modification des proprietes d'une table 

Le tableau represente a la figure 14-8 contient six colonnes regroupees sous la categorie 
Action. Ces colonnes permettent de realiser les modifications suivantes sur les champs de 
la table : 

• Repere © : modification des caracteristiques du champ. Par exemple, le code pour 
renommer le champ id_client en num_client et pour qu'il soit de type SMALLINT en 
conservant les autres caracteristiques est le suivant : 

I ALTER TABLE 'client' CHANGE '1d_cl ient' 'num_cl ient ' SMALLINT NOT 
*NULL AUTO_INCREMENT 

• Repere Q : suppression du champ de la table. Par exemple, le code pour supprimer le 
champ vi 11 e est le suivant : 

ALTER TABLE 'client' DROP 'ville' 

• Repere © : definition du champ comme cle primaire. Par exemple, le code permettant 
que le champ nom fasse aussi partie de la cle primaire est le suivant : 

I ALTER TABLE 'client' DROP PRIMARY KEY , 
ADD PRIMARY KEY ( id_client, 'nom' ) 

Remarquez que la cle primaire est effacee par la commande DROP PRIMARY KEY avant 
d'etre recreee avec deux champs au moyen de la commande ADD PRIMARY KEY(id_ 
cl ient, nom). 

• Repere © : creation d'un index pour ce champ. Par exemple, le code pour creer un 
index sur le champ adresse est le suivant : 

ALTER TABLE 'client' ADD INDEX ('adresse' ) 

Le code pour supprimer cet index est le suivant : 

ALTER TABLE 'client' DROP INDEX 'adresse' 

• Repere : definition du champ comme etant a valeur unique. Par exemple, le code 
pour attribuer l'option UNIQUE au champ mai 1 est le suivant : 

ALTER TABLE 'client' ADD UNIQUE ('mail') 

Le code pour supprimer cette option est le suivant : 

ALTER TABLE 'client' DROP INDEX 'mail' 

• Repere © : creation d'un index sur le texte entier du champ (sauf s'il est numerique). 
Par exemple, le code pour creer un index sur le champ adresse est le suivant : 

ALTER TABLE 'client' ADD FULLTEXT ('adresse' ) 
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Le code pour supprimer 1' index est le suivant : 

ALTER TABLE 'client' DROP INDEX 'adresse' 

Suppression ou renommage d'une table 

Pour supprimer une table, il suffit de cliquer sur le bouton "Supprimer" apres avoir selec- 
tionne la base puis la table. Le code suivant s'affiche : 

DROP TABLE 'client' 

La commande SQL complete de suppression d'une ou de plusieurs tables simultanement 
est le suivant : 

DROP TABLE [IF EXISTS] nom_tablel [, nom_table2, . . . ] 

L'option IF EXISTS evite de provoquer une erreur au cas oil vous tentez d'effacer une 
table qui n'existe pas. 

La commande suivante permet de renommer une ou plusieurs tables : 

RENAME TABLE ex_nom_tablel TO new_nom_tablel [, ex_nom_table2 TO new_nom_table2] 
Par exemple, le code pour renommer la table cl i ent en cl 1 entbi s est le suivant : 

RENAME TABLE client TO cli entbi s 

Creation des cles etrangeres 

En examinant le schema du modele logique de donnees de la figure 14-3, nous pouvons 
constater que les tables commande et ligne comportent des attributs qui sont les copies 
d'attributs d'autres tables. Chaque attribut id_client de la table commande est le report 
d'un attribut du meme nom de la table cl ient. De meme dans la table ligne, chaque attri- 
but id_comm est le report d'un attribut id_comm de la table commande et l'attribut id_article 
celui de l'attribut de la table articl e. On dit que chacun d'eux est une cle etrangere, car il 
a la valeur de la cle primaire d'une autre table, ou bien parce qu'il fait reference a la cle 
d'une autre table. Si nous laissions les quatre tables de la base magasi n dans l'etat ou elles 
sont actuellement, nous nous exposerions a la creation d'incoherences dans la base lors 
de son utilisation. Par exemple, la suppression d'un client laisserait presentes toutes ses 
commandes dans la table commande, et la table 1 igne contiendrait un attribut id_cl ient qui 
ne correspondrait plus a personne. Pour pallier cet inconvenient lors de la suppression 
d'un client, il faudrait ecrire « a la main » les requetes pour effacer les lignes superflues 
dans les tables commande et ligne. En referencjant les cles etrangeres, MySQL se charge 
d'eliminer, dans la table commande, les lignes dont l'attribut id_cl ient a la valeur de i'1d_ 
cl i ent supprime dans la table cl ient. De meme, lors d'une insertion, MySQL verifie si la 
cle etrangere inseree existe bien dans la table referencee. Les tables de type InnoDB 
permettent de gerer les contraintes de cles etrangeres. 

Pour referencer les cles etrangeres, il nous faut tout d'abord creer, dans la table 
commande, un index pour l'attribut id^client. Ceci peut se faire avec phpMyAdmin en 
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cliquant sur l'onglet Structure, puis en cochant la ligne id_client et la case Index, ou en 
tapant le code suivant dans la zone de saisie de l'onglet SQL : 

ALTER TABLE commande ADD INDEX(id_cl ient) 

Pour creer les contraintes de cle etrangeres, il faut selectionner la table commande, puis 
cliquer sur le lien Gestion des relations et choisir l'attribut id_cl ient puis le lier a un de 
ceux qui apparaissent dans la premiere liste deroulante (figure 14-9 repere ©)• Vous 
devez ensuite choisir les actions que MySQL va effectuer en cas de suppression d'une 
valeur de id_cl ient dans la table client (repere©, case ON DELETE), le choix le plus 
courant etant CASCADE, qui entrainera la suppression des lignes dans la table commande si on 
supprime la valeur liee dans la table cl i ent (par consequent, si on supprime un client ses 
commandes seront aussi supprimees). Les autres choix sont SET NULL, NO ACTION et 
RESTRICT. De meme, vous devez choisir Taction a effectuer en cas de mise a jour des 
donnees dans la table client (repere ©, case ON UPDATE) avec les memes choix qui ci- 
dessus. Le code genere est le suivant : 

I ALTER TABLE "commande" 
ADD CONSTRAINT ' commanded bf k_l' FOREIGN KEY C1d_cl ient') REFERENCES 
'•'client' Cid_client') ON DELETE CASCADE ON UPDATE CASCADE; 
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Figure 14-9 

Creation des relations entre les tables 



Exportation d'une table 



Une fonctionnalite tres interessante offerte par phpMy Admin est la possibilite d' exporter 
dans un fichier tout le code SQL de creation d'une table. Ce fichier, dont 1' extension est 
. sql , permet par exemple, en phase de test, de creer rapidement sur un serveur distant les 
memes tables que celles creees sur le serveur local. 

II est en outre possible d' exporter les donnees inserees dans la table locale en meme temps 
que la structure de la table et de les retrouver telles quelles dans la base de l'hebergeur. 

Pour exporter une table, il suffit de cliquer sur le bouton Exporter apres avoir choisi la 
base et la table concernees. Dans la page qui s'affiche comme illustre a la figure 14-10, il 
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est possible de choisir le format d' exportation (reperes Q a 0), ainsi que 1' exportation de 
la structure de la table (repere 0) avec ou sans les donnees qu'elle contient (repere Q). 

Seule 1' activation de la case Transmettre (repere ©) permet de transmettre ces infor- 
mations dans un fichier, compresse ou non (repere Q). Si la case n'est pas cochee, 
phpMyAdmin affiche le code dans une nouvelle page. 

Le contenu du fichier a rti cl e . sql obtenu est le suivant : 

-- phpMyAdmin SQL Dump 

-- version 2.11.6 

-- http://www.phpmyadmin.net 

-- Serveur: localhost 

-- Genere le : Lun 01 Decembre 2008 a 13:39 

-- Version du serveur: 5.0.51 

-- Version de PHP: 5.2.6 

SET SQL_M0DE="N0_AUT0_VALUE_0N_ZER0"; 



Base de donnees: "magasin" 



Structure de la table "article" 



CREATE TABLE "article" ( 

"id_article" char(5) collate latinl_bin NOT NULL, 

"designation" varchar(lOO) collate latinl_bin NOT NULL, 

"prix" decimal (8,2) NOT NULL, 

"categorie" enum( 'tous' , 'photo' , 'video' , ' informatique' , 'divers ' 

^•collate latinl_bin NOT NULL default 'tous', 

PRIMARY KEY ( "id_article" ) 
) ENGINE=InnoDB DEFAULT CHARSET=latinl C0LLATE=latinl_bin; 



Contenu de la table "article" 



INSERT INTO "article" ( "id_article~ , "designation", "prix" , "categorie" ) VALUES 

CCA300', 'Canon EOS 3000V zoom 28/80', '329.00', 'photo'), 

CCAS07' 

CCP100' 

CCS330' 

CDEL30' 



'Cassette DV60 par 5', '26.90', 'divers'), 
'Camescope Panasonic SV-AV 100', '1490.00', 'video'), 
'Camescope Sony DCR-PC330', '1629.00', 'video'), 
'Portable Dell X300', '1715.00', 'informatique'), 



PHP 5 



DVD75' 
HP497' 

NIK55' 
NIK80' 
SAX15' 



CSOXMP' 



'DVD vierge par 3', '17.50', 'divers'), 

'PC Bureau HP497 ecran TFT', '1500.00', ' informatique' ) , 

'Nikon F55+zoom 28/80' , '269.00', 'photo'), 

'Nikon F80' , '479.00', 'photo'), 

'Portable Samsung X15 XVM' , '1999.00', 'informatique'), 

'PC Portable Sony Zl-XMP', '2399.00', 'informatique'); 



Le fichier contient egalement les donnees pour remplir la table apres sa creation. 
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Figure 14-10 

Page d 'exportation des tables 



Pour reutiliser ce fichier sur un serve ur distant, il suffit de se connecter au site puis, dans 
le phpMy Admin du serveur, selectionner la base et cliquer sur le bouton SQL, comme 
illustre au repere Q de la figure 14-11. Dans la page qui s'affiche, cliquez sur le bouton 
Parcourir (repere ©) pour retrouver le fichier article.sql sur le disque du poste. Apres 
un clic sur le bouton Executer (repere ©), le serveur execute le code SQL contenu dans 
le fichier et cree la table correspondante sur le serveur distant. Vous pouvez aussi effec- 
tuer un copier-coller dans la fenetre SQL. 
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Figure 14-11 

Utilisation d'un fichier .sqlpour creer une table 

Insertion de donnees 

Une fois les tables creeses, differents moyens permettent d'y enregistrer les donnees 
necessaires au fonctionnement d'un site de commerce en ligne. 

II existe deux grandes categories de donnees, les donnees statiques, qui ne dependent que 
de l'administrateur du site, comme celles de la table article, qui constituent le contenu 
du magasin, et les donnees en provenance des internautes clients du site, qui rempliront 
les autres tables. Ces dernieres informations sont obtenues a partir d'un formulaire de 
saisie alors que les donnees statiques peuvent etre enregistrees aussi bien a partir d'un 
formulaire en ligne qu'a l'aide de phpMyAdmin. 



Insertion ligne par ligne 

Vous allez commencer par inserer les donnees dans la table article. II suffit pour cela de 
cliquer sur la base magasi n dans la page d'accueil de phpMyAdmin puis, dans 1' ensemble 
des tables de la base qui s'affichent, de selectionner la table voulue et de cliquer sur le 
bouton Inserer. Un formulaire de saisie s'affiche alors comme illustre a la figure 14-12. 

En cliquant sur le bouton "Enregistrer", vous generez l'affichage du code SQL de la 
requete, par exemple le suivant : 



INSERT INTO 'article' ( 'id_article' , 'designation' 

VALUES ( 

'CS110', 'Camescope Sony 110', '1250.50', 'video' 

); 
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Figure 14-12 

Insertion de donnees ligne par ligne 

La syntaxe generate de la commande INSERT se decline sous trois formes. 

Dans une premiere forme, le nom des colonnes est facultatif si les valeurs sont inserees 
dans le meme ordre que celui de la table : 

I INSERT [DELAYED | L0W_PRI0RITY] [IGNORE] 
INTO table [col l,col2, . . . ] 
VALUES (vall,val2,...) 

Le mot-cle DELAYED indique que les donnees ne seront inserees qu'apres execution des 
autres commandes SQL. Le mot-cle L0W_PRI0RITY indique au serveur d'attendre qu'il n'y 
ait plus aucun client connecte pour inserer les donnees. Le mot-cle IGNORE permet de ne 
pas inserer de lignes qui existent deja. 

La deuxieme forme n'est qu'une variante de la premiere, dans laquelle vous definissez 
explicitement la valeur de chaque colonne. Elle est de preference employee pour n'inse- 
rer des valeurs que dans certaines colonnes : 

I INSERT [DELAYED | L0W_PRI0RITY] [IGNORE] 
INTO table 
SET coll= vall,col2= val2 

La derniere forme permet d'inserer des donnees a partir du resultat d'une selection 
operee dans une autre table. Vous pourriez, par exemple, creer une table ne contenant que 
le nom et l'adresse e-mail des clients et la remplir a l'aide de cette commande a partir de 
la table client : 

I INSERT [DELAYED | L0W_PRI0RITY] [IGNORE] 
INTO table [col l.colZ. . . . ] 
SELECT expression 



INSERT el REPLACE 

Vous pouvez utiliser la commande REPLACE a la place de I NSERT avec la meme syntaxe. Elle sert a modifier 
les valeurs d'une ligne sans modifier son identifiant. 
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Mise a jour des donnees 

Lors du cycle de vie d'une base de donnees, il peut etre indispensable de mettre a jour 
certaines donnees sans avoir a supprimer une ligne complete puis reecrire les nouvelles 
informations. 

La premiere solution est bien stir d'utiliser phpMyAdmin, de selectionner la base, d'affi- 
cher la table et de cliquer sur l'icone Modifier, ce qui entraine l'affichage d'une page de 
saisie. Vous pouvez alors modifier une ou plusieurs valeurs de la ligne concernee. 

Pour realiser cette operation avec une requete SQL, vous disposez de la commande UPDATE, 
dont la syntaxe generale est la suivante : 

UPDATE[LOW_PRIORITY] [IGNORE] nonstable 
SET colonnel = valeurl,colonne2=valeur2,... 
[WHERE condition 
[LIMIT N] 

La condition qui suit la commande WHERE peut permettre d'operer une mise a jour unique - 
ment pour les lignes repondant a une condition particuliere. La clause LIMIT permet de 
limiter la mise a jour aux N premieres lignes. 

Par exemple, pour modifier la date d'une commande dans la table commande, si l'identi- 
fiant de commande a la valeur 2, vous ecrivez la requete suivante : 

UPDATE commande SET date = '2008-11-25' WHERE id_comm = '2' LIMIT 1 ; 

Importation a partir d'un fichier texte 

L'insertion ligne par ligne devient rapidement rebarbative lorsqu'il s'agit de saisir un 
grand nombre de donnees. Si ces donnees sont recuperables a partir d'un catalogue, il 
est possible de les inclure en une seule operation a condition qu'elles soient formatees 
selon les memes criteres que ceux que vous avez utilises pour les fichiers texte (voir le 
chapitre 11). 

Chaque donnee doit etre delimitee par un caractere particulier (par defaut des guillemets) 
et separee des autres par un autre caractere (par defaut le point-virgule). Chaque groupe 
de donnees correspondant a une ligne de la table doit etre delimite par un troisieme carac- 
tere (par defaut la sequence \r\n). 

Pour importer une liste de donnees dans la table, vous devriez, par exemple, creer le 
fichier article_texte.txt dont le contenu visualise dans le Bloc-notes de Windows est 
illustre a la figure 14-13. 

Pour realiser ce type d' importation, vous devez selectionner la base, puis la table et 
cliquer sur l'onglet Importer. Vous obtenez alors une page identique a celle de la 
figure 14-14. 
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C article_texte - Bloc-notes |- || 


Blf 




Fichier Edition Format Affichage ? 




"CS33Q"; "camescope Sony DCR-PC33Q"; "1629"; "1" 

"NIK55"; "Nikon F55+zoom 28/80"; "269"; "photo" 

"NIK80"; "Nikon F80"; "479"; "photo" 

"so>MP";"PC Portable Sony Z1->MP"; "2399"; "3" 

"HP497";"PC Bureau HP497 ecran TFT"; "1500"; "inf ormatique" 

"DVD75";"DVD vierge par 3"; "17. 50"; "divers" 











Figure 14-13 

Le fichier texte visualise dans le Bloc-notes 
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Figure 14-14 

Formulaire d'insertion apartir d'un fichier texte 



Si le fichier est situe sur le poste client, vous pouvez utiliser le bouton Parcourir 
(repere Q) pour le localiser et conserver le choix par defaut DATA LOCAL (repere @). 

Pour executer vous-meme cette operation, vous ecririez la requete SQL suivante : 

LOAD DATA INFILE 'C:/arti cle_texte.txt' 

INTO TABLE 'article - 

FIELDS TERMINATED BY ' ; ' 

ENCLOSED BY "" 

ESCAPED BY 'W 

LINES TERMINATED BY '\r\n' 
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Vous avez la possibility de definir vos propres valeurs pour les options suivantes : 

• « Champs termines par », qui correspond a l'option SQL FIELDS TERMINATED BY. 

• « Champs entoures par », qui correspond a l'option SQL ENCLOSED BY. 

• « Caractere special », qui correspond a l'option SQL ESCAPED BY qui permet de choisir 
le caractere d'echappement. 

• « Lignes terminees par », qui correspond a l'option SQL LINES TERMINATED BY. 

II est cependant preferable de conserver les parametres par defaut. 

En cliquant sur le bouton Afficher, vous pouvez verifier que l'insertion des donnees s'est 
effectuee correctement et en conformite avec le fichier texte. Vous obtenez 1' ensemble de 
la table, dans la limite de 30 lignes a la fois, comme illustre a la figure 14-15. 



id_article 


designation 


prix 


categorie 


CS330 


Camescope Sony DCR-PC330 


1629.00 


video 


NIK55 


Nikon F55+ioom 28/BO 


209.00 


photo 


NIKBO 


Nikon FBO 


479.00 


photo 


SOXMP 


PC Portable Sony Z1-XMP 


2399.00 


informatique 


HP497 


PC Bureau HP497 ecran TFT 


1500.00 


informatique 


DVD75 


DVD vierge par 3 


17.50 


divers 



Figure 14-15 

La table articles apres insertion de donnees 

Si vous souhaitez inserer des donnees dans une table dont la cle primaire est un entier 
ayant l'option AUT0_INCREMENT selectionnee, le fichier texte doit contenir a la place de cette 
cle la valeur NULL representee par la chaine "\N". Pour inserer une liste de clients dans la 
table cl i ent, par exemple, vous utiliseriez un fichier texte ayant la structure suivante : 

I"\N" ; "Marti " ; "Jean" ; "36" ; "5 av Einstein" ; "Orleans" ;mart@marti .com 
"\N" ; "Rapp" ; "Paul " ;"44" ; "8 rue du Port" ; "Paris" ;rapp@l ibert.com 

Insertion a partir d'un fichier Excel 

La figure 14-16 represente une feuille de tableur Excel contenant un ensemble de donnees 
presentees selon l'ordre des colonnes de la table a rt i cl e. Pour les enregistrer dans la table, 
vous devez enregistrer la feuille au format CSV puis choisir « CSV (separateur : point 
virgule) » comme type de fichier. Vous obtenez un fichier avec 1' extension .csv, dont la 
structure est similaire a celle d'un fichier texte, le separateur choisi entre chaque champ 
etant ;. 
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La procedure d'insertion est la meme que pour un fichier texte ordinaire. 



X Microsoft Excel - article_excel 


^J Fichier Edition AfTichage Insertion Format Outils Donnees Fenetre ? 


□ o£B 


a 


a^ 


Jtllg^ 


m -r m - 


!,*? 


E f« H 11 


If 








Arial 


- 10 - | 6 I S 


= « 3 S 9 % DDD tsg i°$ i F iF 


Al 


J =|CS330 




A 


1 B 


c 


D 


E 


1 


CS330 


ICamescope Sony DCR-PC330 


1629 


1 




2 


NIK55 


Nikon F55+zoom 28/80 


269 


photo 




3 


NIK80 


Nikon F80 


479 


photo 




4 


SOXMP 


PC Portable Sony Z1-XMP 


2399 


3 




5 


HP497 


PC Bureau HP497 ecran TFT 


1500 


informatique 




6 


DVD75 


DVD vierge par 3 


17.5 divers 




7 











Figure 14-16 

Feuille de calcul Excel a inserer 



Les donnees de la base magasin 



Avant de proceder a des operations de selection des donnees a l'aide de code SQL, il 
vous faut mieux comprendre les resultats affiches par les differentes requetes sur la base 
magasi n. Ces resultats sont recapitules aux tableaux 14-4 pour la table cl i ent, 14-5 pour la 
table article, 14-6 pour la table commande et 14-7 pour la table ligne. 



Tableau 14-4 - Donnees de la table client 



id client 


nom 


prenom 


age 


adresse 


ville 


mail 


1 


Marti 


Jean 


36 


5 av. Einstein 


Orleans 


mart@marti.com 


2 


Rapp 


Paul 


44 


32 av. Foch 


Paris 


rapp@libert.com 


3 


Devos 


Marie 


18 


75 bd Hochimin 


Lille 


grav@waladoo.fr 


4 


Hochon 


Paul 


22 


33 rue Tsetse 


Chartres 


hoch@fiscali.fr 


5 


Grave 


Nuyen 


18 


75 bd Hochimin 


Lille 


grav@waladoo.fr 


6 


Hachette 


Jeanne 


45 


60 rue dAmiens 


Versailles 


NULL 


7 


Marti 


Pierre 


25 


4 av. Henri 


Paris 


martin7@fiscali.fr 


8 


Mac Neal 


John 


52 


89 rue Diana 


Lyon 


mac@freez.fr 


9 


Basile 


Did 


37 


26 rue Gallas 


Nantes 


bas@walabi.com 


10 


Dare 


Jeanne 


19 


9 av. d'Orleans 


Paris 


NULL 


11 


Gate 


Bill 


45 


9 bd des Bugs 


Lyon 


bill@microhard.be 
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Tableau 14-5 - Donnees de la table article 



id article 


designation 


prix 


1 

categorie 


CS330 


Camescope Sony DCR-PC330 


1629.00 


video 


NIK55 


Nikon F55+zoom 28/80 


269.00 


photo 


NIK80 


Nikon F80 


479.00 


photo 


SOXMP 


PC portable Sony Z1-XMP 


2399.00 


informatique 


HP497 


PC bureau HP497 ecran TFT 


1500.00 


informatique 


DVD75 


DVD vierge par 3 


17.50 


divers 


CAS07 


Cassette DV60 par 5 


26.90 


divers 


DEL30 


Portable Dell X300 


1715.00 


informatique 


CP100 


Camescope Panasonic SV-AV100 


1490.00 


video 


SAX15 


Portable Samsung X15 XVM 


1999.00 


informatique 


CA300 


Canon EOS 3000V zoom 28/80 


329.00 


photo 



Tableau 14-6 - Donnees de la table commande 



Tableau 14-7 - Donnees de la table ligne 



id comm 


id client 


date 


M 


5 


2008-06-11 


2 


9 


2008-06-25 


3 


1 


2008-07-12 


4 


3 


2008-07-14 


5 


9 


2008-07-31 


6 


10 


2008-08-08 


7 


2 


2008-08-25 


8 


7 


2008-09-04 


9 


11 


2008-10-15 


10 


4 


2008-11-23 


11 


8 


2009-01-21 


12 


5 


2009-02-01 


13 


9 


2009-03-03 



id_comm 


id article 


quantite 


prixunit 


M 


CS330 


1 


1629.00 


M 


CAS07 


3 


26.90 


2 


HP497 


2 


1500.00 


3 


NIK80 


5 


479.00 


4 


SOXMP 


3 


2399.00 


4 


DVD75 


2 


17.50 


5 


CA300 


1 


329.00 


6 


CAS07 


3 


26.90 


6 


CP100 


1 


1490.00 


7 


SAX15 


5 


1999.00 


8 


SOXMP 


1 


2399.00 


8 


CP100 


1 


1490.00 


9 


NIK55 


1 


269.00 


10 


DEL30 


2 


1715.00 


10 


SAX15 


1 


1999.00 


11 


DVD75 


10 


17.50 


12 


CS330 


3 


1629.00 


12 


CAS07 


4 


26.90 


13 


SAX15 


2 


1999.00 
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Selection des donnees 

L' operation la plus importante pour creer une page dynamique en reponse a une 
demande formulee par un visiteur est la selection des donnees qui vont composer cette 
page. II est pour cela necessaire de bien maitriser les commandes SQL de selection des 
donnees et de s'assurer que l'operation de selection retenue fournit bien les resultats 
attendus et uniquement ceux-ci. 

La selection des donnees peut porter sur une table (selection simple) ou sur deux ou 
plusieurs tables simultanement (il s'agit alors d' une jointure). Pour illustrer l'importance 
du choix des commandes SQL de selection, vous n'utiliserez pas les possibilites d'auto- 
matisation du code SQL offertes par phpMy Admin mais ecrirez a la main chacune des 
requetes a executer. 

Commencez par choisir la base magasin, puis la table a interroger et cliquez sur l'onglet 
SQL. Vous obtenez la page illustree a la figure 14-17. Vous saisirez vos requetes dans la 
zone de saisie multiligne (repere ©). la liste des attributs de la table apparait dans une 
liste deroulante a droite (repere ©) afin d'eviter les erreurs dans la saisie des attributs. 

^rj Son/our: localhosi ^ fo Base de donnees: magasin ^ Qi£j Table: client ItmdDB free: 4036 kB~ 

EAIfklitfi tff S[rui[uie i™ SQL ^ Rtfi-lieTL'Iwi ]»r li I iMJi e I H&gportgl S^hnportlgt StOg&fBjkgW HVTtjgl y SLt(]ptiiiitfi 

Executer une ou des requeies sur la base magasin: © 



eiliCT nsi, prDtiDC cT^M 'client ' | 
1 



nhsmps 



.d_clienl 
nom 
prenorn 
age 



1 



| Dylhiiilyui ; ] j] Reallkjiui la ret|ui?Le aprey yxetuliui Executor I 



(Juoth une nouvelle lenelre phpMyAdmir 



Figure 14-17 

La page de saisie des requetes 

Selection dans une table 

La commande SQL essentielle pour operer des selections de lignes dans une table est 
SELECT. Elle comporte de nombreuses options en fonction du resultat souhaite. Les 
sections qui suivent detaillent les plus importantes d'entre elles. 

Selection de toutes les lignes 

Pour operer une selection de toutes les lignes et de toutes le colonnes d'une table, ecrivez : 

SELECT * FROM client 
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Le seul interet de cette requete est de visualiser l'ensemble des donnees. Elle a le meme 
effet que le bouton Afficher de phpMyAdmin. 

Pour restreindre l'affichage a certaines colonnes, vous pouvez les enumerer. 

La commande suivante : 

SELECT nom.prenom.vil l e FROM client 

n'affiche que les trois colonnes indiquees avec leurs valeurs pour toutes les lignes de la 
table client. 



Alias 

Dans les requetes de selection, vous pouvez definir des alias pour les noms des bases, des tables ou des 
colonnes. Lors de l'affichage, les noms affiches sont ceux des alias et non ceux des colonnes de la table. 



Ces exemples affichent toutes les lignes de la table, y compris si cette derniere contient 
des doublons. Pour ne pas afficher plusieurs fois les memes donnees, vous pouvez utiliser 
la clause DISTINCT. 

L'exemple suivant : 

SELECT DISTINCT ville FROM client 
affiche la liste des villes sans doublon, comme ci-dessous : 



ville Orleans Paris Lille Chartres Versailles Lyon Nantes 



Vous pouvez trier les champs affiches par ordre croissant ou decroissant en utilisant la 
clause ORDER BY du nom du champ et des options ASC (croissant) ou DESC. 

La requete suivante : 

SELECT DISTINCT ville FROM client ORDER BY ville ASC 
affiche la liste ordonnee des villes, comme ci-dessous : 



ville Chartres Lille Lyon Nantes Orleans Paris Versailles 



La requete suivante : 

SELECT DISTINCT ville FROM client ORDER BY ville DESC 
affiche la meme liste en ordre inverse, comme ci-dessous 



ville Versailles Paris Orleans Nantes Lyon Lille Chartres 
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Restriction du nombre de lignes 

La possibility de restreindre le nombre de lignes illustre tout l'interet des operations de 
selection. Elle permet aux donnees auxquelles est appliquee la restriction de repondre a 
une ou plusieurs conditions particulieres. Pour appliquer une restriction, il suffit d'ajou- 
ter la clause WHERE a la commande SELECT. 

La syntaxe generale de la commande SELECT devient : 

SELECT coll,col2,... FROM table WHERE condition 

La condition peut porter sur n'importe quelle colonne. Elle doit etre redigee a l'aide 
d'operateurs et de fonctions, a la maniere des expressions conditionnelles des instruc- 
tions if. 

Par exemple, pour selectionner les clients qui habitent Paris, vous ecrivez : 

SELECT nom.prenom.adresse.mail FROM client WHERE vil le=' Paris ' 
Vous obtenez la liste illustree a la figure 14-18. 



nom 


prenom 


adresse 


mail 


Rapp 


Paul 


32 AvFoch 


rapp@libert.com 


Marti 


Pierre 


4 Av Henri 


martin7@iscali.fr 


Dare 


Jeanne 


9 Avd'Orleans 


NULL 



Figure 14-18 

Selection avec une clause WHERE 



Les operateurs de comparaison 

Les operateurs de comparaison sont applicables a tous les types de donnees. lis donnent 
pour resultats les valeurs TRUE, FALSE ou NULL. Les operandes sont convertis en nombre ou 
en chaine selon le contexte. 

Pour les chaines, la comparaison est insensible a la casse et ignore les espaces, les tabu- 
lations (\t) et les sauts de ligne (\n). 

Tableau 14-8 - Les operateurs de comparaison 



Operateur 


Description 


1 


\- 


Egalite des nombres ou des chaines de caracteres 




Oou ! = 


Different de 




<= 


Inferieurou egal a 




< 


Inferieura 




>= 


Superieur ou egal a 




> 


Superieur a 
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Tableau 14-8 - Les operateurs de comparaison (suite) 



express NOT BETWEEN 
min AND max 



express LIKE 'motif 



express NOT LIKE 'motif 
express REGEXP 'motif 



express NOT REGEXP 'motif 
express IN(val l.va!2, . . . ) 



express NOT IN(vall, 
va!2,...) 



ISNULL(express) 



C0ALESCE(coll.col2,...) 



Operateur 


1 

Description 


IS NULL 


Retourne TRUE si la valeurest NULL. Par exemple : 

SELECT nom.prenom FROM auteurs WHERE prenom IS NULL 


IS NOT NULL 


Retourne TRUE si la valeur n'est pas NULL. Par exemple : 

SELECT nom.prenom FROM auteurs WHERE prenom IS NOT NULL 


express BETWEEN 
min AND max 


Retourne TRU E si la valeur est comprise entre mi n et max (limites comprises). Par exem- 
ple, le code suivant selectionne tous les noms dont I'initiale est comprise entre A et E : 

SELECT nom FROM client WHERE nom BETWEEN 'A' and 'E' 



Retourne TRUE si la valeur n'est pas comprise entre mi n etmax (limites comprises). Par 
exemple, le code suivant selectionne tous les noms dont I'initiale n'est pas comprise 
entre A et E : 

SELECT nom FROM client WHERE nom NOT BETWEEN 'A' and 'E' 

Retourne la valeur TRUE si I'expression est conforme au motif defini. Pour definir les 
motifs, vous utilisez deux caracteres particuliers, ou jokers : le caractere de souligne- 
ment (_) pour remplacer un caractere quelconque et le caractere % pour remplacer un 
nombre variable de caracteres. 

Si le motif est egal a 'chaine', tous les mots commengant par 'chaine' suivi de 
n'importe quel caractere conviennent. Si le motif est egal a 'Xmar', tous les mots qui 
contiennent la chaine ' ma r ' precedee de n'importe quel groupe de caracteres convien- 
nent. Si le motif est ' %na r% ' , toutes les chaines contenant simplement la chaine ' ma r ' 
sont valables. Par exemple, le code suivant selectionne tous les noms qui contiennent 
les lettres 'tin' : 
SELECT nom.prenom FROM client WHERE nom LIKE 'Xtin' 

Negation de I'operateur LIKE 

Retourne TRUE si le motif de I'expression reguliere est trouve dans la valeur d'une 
colonne. Par exemple, le code suivant selectionne tous les noms dont le prenom 
commence par la lettre J suivie d'une voyelle puis d'un nombre quelconque de caracteres : 

SELECT nom 

FROM client WHERE prenom REGEXP ' J[aeiouy] .*' 

Negation de I'operateur REGEXP 

Retourne TRU E si la valeur est incluse dans I'ensemble des valeurs listees. Par exemple, 
le code suivant selectionne tous les noms d'auteurs qui ont 21 , 22 ou 23 ans : 

SELECT nom FROM auteurs WHERE age IN (21,22.23) 

Retourne TRUE si la valeur n'est pas incluse dans I'ensemble des valeurs listees. Par 
exemple, le code suivant selectionne tous les noms d'auteurs qui n'ont ni 21, ni 22 ni 
23 ans : 

SELECT nom FROM auteurs WHERE age NOT IN (21,22.23) 

Retourne TRUE si la valeur de I'expression est de type NULL. Par exemple, le code 
suivant selectionne tous les noms d'auteurs dont I'attribut prenom est vide : 
SELECT nom FROM auteurs WHERE ISNULL(prenom) 

Retourne la premiere valeur non NULL de la liste passee en parametre. Par exemple, le 
code suivant retourne tous les e-mails non NULL de la table client, les mails NULL 
etant remplaces par les noms : 
SELECT COALESCE! mail, nom ) FROM client 
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Exemples de requetes avec des operateurs 

• Pour selectionner les clients dont l'age est superieur a 40 ans 



SELECT nom, prenom, age,adresse,vil le 
FROM client WHERE age >40 



nom 


prenom 


age 


adresse 


ville 


Rapp 


Paul 


44 


32 AvFoch 


Paris 


Hachette 


Jeanne 


45 


60 rue d'Amiens 


Versailles 


Mac Neal 


John 


52 


89 rue Diana 


Lyon 


Gate 


Bill 


45 


9 Bd des Bugs 


Lyon 



Pour selectionner les clients qui n'ont pas d' adresse e-mail : 

SELECT nom, prenom, age, adresse, ville 



FROM client 



HERE mail IS NULL 



nom 


prenom 


age 


adresse 


ville 


Hachette 


Jeanne 


45 


60 rue d'Amiens 


Versailles 


Dare 


Jeanne 


19 


9 Avd'Orleans 


Paris 



Pour selectionner les clients dont les noms commencent par une lettre entre A et H, la 
lettre H n'etant pas prise en compte : 



SELECT nom, prenom, age, ville 
FROM client WHERE nom BETWEEN 



A' AND "H" 



nom 


prenom 


age 


ville 


Devos 


Marie 


18 


Lille 


Grave 


Nuyen 


18 


Lille 


Basile 


Did 


37 


Nantes 


Dare 


Jeanne 


19 


Paris 


Gate 


Bill 


45 


Lyon 



Pour selectionner les articles dont le prix est compris entre 1 000 et 2 000 euros : 

SELECT id_article, designation, prix FROM article WHERE prix BETWEEN 1500 AND 2000 
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id_article 

CS330 


designation 


prix 


Camescope Sony DCR-PC330 


1629.00 


HP497 


PC Bureau HP497 ecran TFT 


1500.00 


DEL30 


Portable Dell X300 


1715.00 


S/W15 


Portable Samsung X1 5 WM 


1999.00 



Pour selectionner les clients dont l'age figure dans la liste (18, 19, 20) : 

SELECT nom, prenom, age, ville FROM client WHERE age IN ( 18, 19, 20 ) 



nam 


prenom age 


uille 


Devos 


Marie 18 


Lille 


Grave 


Nuyen 18 


Lille 


Dare 


Jeanne 19 


Paris 



Pour selectionner les clients qui habitent une avenue, et dont l'adresse contient done la 
chaine av. : 

j SELECT nom, prenom, age, adresse, ville FROM client WHERE adresse LIKE '%Av%' 



nom 


prenom 


aoe 


adresse 


ville 


Marti 


Jean 


36 


5 Av Einstein 


Orleans 


Rapp 


Paul 


44 


32AvFoch 


Paris 


Marti 


Pierre 


25 


4 Av Henri 


Paris 
Paris 


Dare 


Jeanne 


19 


9 Ave] 'Orleans 



Pour selectionner les articles de la marque Sony, dont la designation contient done la 
chaine Sony : 

j SELECT id_article, designation, prix FROM article WHERE designation LIKE '%Sonyr 



id_article 


designation 


prix 


CS330 
SOXMP 


Camescope Sony DCR-PO330 
PC Portable Sony Z1-XMP 


1629.00 
2399.00 
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Pour selectionner les clients dont les noms commencent par Ma a l'aide d'une expression 
reguliere : 

I SELECT nom, prenom, age, adresse, ville 
FROM client WHERE nom REGEXP 'Ma.*' 



nom 


prenom 


age 


adresse 


ville 


Marti 


Jean 


36 


5 Av Einstein 


Orleans 


Marti 


Pierre 


25 


4 Av Henri 


Paris 


Mac Neal 


John 


52 


89 rue Diana 


Lyon 



Les operateurs logiques 

II est evidemment possible d'ecrire des conditions complexes dans la clause WHERE en 
reliant plusieurs conditions par des operateurs logiques. La liste et la description de ces 
operateurs est donnee au tableau 14-9. 

Une expression contenant un ou deux operandes relies par un operateur logique est 
evaluee a TRUE (1), FALSE (0) ou NULL. 

Tableau 14-9 - Les operateurs logiques 

Operateur Description 

NOT express Le NON logique renvoie FALSE si express vaut TRUE et reciproquement ou NULL si express vaut 

ou lexpress NULL. Par exemple, le code suivant retourne tous les noms differents de 'dupont' : 

SELECT nom FROM client WHERE NOT(nom='dupont ' ) 

expressl Le ET logique renvoie TRU E si les deux operandes sont differents de FALSE et de NU LL et renvoie 

AND FALSE s'ils sont tous deux FALSE. Dans les autres cas, revaluation est NULL. Par exemple, le 

express2 code suivant retourne tous les ages des clients nommes 'pierre dupont' : 

SELECT age FROM client WHERE nom='dupont' AND prenom='pierre' 

expressl Le OU logique renvoie TRUE si au moins un des operandes vaut TRUE, NULL si I'un des deux est 

OR NULL et FALSE dans les autres cas. Par exemple, le code suivant retourne tous les ages des 

express2 clients dont le nom est 'dupont ' ou le prenom 'pierre' : 

SELECT age FROM client WHERE nom='dupont' OR prenom='pierre' 

expressl Le OU exclusif logique renvoie NULL si I'un des operandes vaut NULL, TRUE si un seul des deux 

XOR vaut TRUE et FALSE sinon. Par exemple, le code suivant retourne les ages des clients dont le 

express nom est 'dupont' et dont le prenom n'est pas 'pierre' ainsi que de ceux dont le prenom est 

'pierre' et dont le nom est different de 'dupont' : 
SELECT age FROM client WHERE nom='dupont' XOR prenom=' pierre' 

Exemples utilisant les operateurs logiques 

Pour selectionner les clients qui ont moins de 30 ans et qui habitent Paris : 

SELECT nom, prenom, age, adresse, ville 

FROM client WHERE age <30 AND ville = 'Paris' 
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nom 


prenom 


age 


adresse 


ville 


Marti 


Pierre 


25 
19 


4 Av Henri 
9 Avd'Orleans 


Paris 
Paris 


Dare 


Jeanne 



Pour selectionner les clients qui habitent Lyon ou dont le nom commence par la lettre H 

I SELECT nom, prenom, age, adresse, vil le FROM client 
WHERE ville='Lyon' OR nom LIKE 'H%' 



nom 

Hochon 


prenom 

Paul 


age 


adresse 


ville 


22 


33 rue Tsetse 


Chartres 


Hachette 


Jeanne 


45 


60 rue d'Amiens 


Versailles 


Mac Neal 


John 


52 


89 rue Diana 


Lvon 


Gate 


Bill 


45 


9 Bd des Bugs 


Lvon 



Pour selectionner les clients qui n'habitent ni a Paris ni a Lyon 

I SELECT nom, prenom, age, adresse, vil le 
FROM client 
WHERE N0T(ville=' Paris' ) AND NOTtvil le=' Lyon' ) 



nom 


prenom 


age 


adresse 


ville 


Marti 


Jean 


36 


5 Av Einstein 


Orleans 


Devos 


Marie 


18 


75 Bd Hochimin 


Lille 
Chartres 


Hochon 


Paul 


22 


33 rue Tsetse 


Grave 


Nuyen 


18 


75 Bd Hochimin 


Lille 


Hachette 


Jeanne 


45 


60 rue dAmiens 


Versailles 
Nantes 


Basils 


Did 


37 


26 rue Gallas 



Les operateurs arithmetiques 

MySQL reconnait les quatre operations fondamentales (+, -, *, /) plus l'operateur 
modulo (%). Excepte pour la division, si les operandes sont entiers, le resultat est de type 
BIGINT 64 bits. Si un seul des operandes comporte l'option UNSIGNED, le resultat a aussi 
cette propriete UNSIGNED. En cas de depassement de la capacite du type BIGINT, le resultat 
est 0. Le resultat de la division par zero a la valeur NULL, et l'operation ne provoque pas 
d'erreur visible. 
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Les fonctions mathematiques 

MySQL gere un grand nombre de fonctions mathematiques classiques, telles que celles 
que vous avez definies dans la partie specifique de PHP (voir chapitre 2). 

Le tableau 14-10 recapitule les fonctions mathematiques utilisables dans des requetes. 
Tableau 14-10 - Fonctions mathematiques 



Fonctions 




I 

Description 


-x 




Oppose de X 


ABS(X) 




Valeur absolue de X 


ACOS(X) 




Angle en radian dont le cosinus est X. 


ASIN(X) 




Angle en radian dont le sinus est X. 


ATAN(X) 




Angle en radian dont la tangente est X. 


ATAN2(X,Y) 




Angle en radian dont la tangente est la valeur de X/Y. 


CEILING(X) 




Arrondi a rentier superieur a X 


COS(X) 




Cosinus de X en radian 


COT(X) 




Cotangente de X en radian 


DEGREES(X) 




Convertit X de radian en degre. 


EXP(X) 




Exponentielle de base e de X 


FLOOR(X) 




Arrondi a rentier inferieur a X 


GREASTESKX 


,Y....) 


Retourne la plus grande valeur de la liste. Utilisable avec des nombres et des lettres. 


LEASTCX.Y,. 


..) 


Retourne la plus petite valeur de la liste. Utilisable avec des nombres et des lettres. 


LOG(X) 




Logarithme neperien de X 


LOGIO(X) 




Logarithme de base 1 de X 


MOD(X.N) 




Modulo : reste de la division de X par N (equivalent de X£N) 


Pit) 




Valeur de pi 


POWX.Y) ou 


POWER(X.Y) 


Nombre X a la puissance Y (X et Y peuvent etre decimaux). 


RADIANS(X) 




Convertit X de degre en radian. 


RANDO ouRAND(N) 


Retourne un nombre aleatoire compris entre et 1 . Si le parametre N est precise, 
ce nombre est utilise pour initialiser le generateur aleatoire. A chaque valeur de N 
correspond un nombre unique toujours identique. 


ROUND(X) 




Arrondit a rentier le plus proche. 


SIGN(X) 




Retourne - 1 , ou 1 selon que X est negatif, nul ou positif. 


SIN(X) 




Sinus de X exprime en radian 


SQRT(X) 




Racine carree de X, qui doit etre positive. 


TAN(X) 




Tangente de X exprimee en radian 


TRUNCATEtX, 


N) 


Arrondit X avec N decimales. 
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Les fonctions statistiques 

Ces fonctions operent sur les donnees d'une meme colonne. Elles retournent des resultats 
calcules sur l'ensemble des valeurs non NULL correspondant a cette colonne. II est possi- 
ble de combiner plusieurs fonctions statistiques a condition d'utiliser la clause GROUP BY, 
que nous detaillons a la section suivante. 

Le tableau 14-11 recapitule les fonctions statistiques utilisables dans des requetes MySQL. 
Tableau 14-11 - Fonctions statistiques 



Fonction 


1 

Description 


AVG(colonne) 


Retourne la moyenne des valeurs de la colonne precisee. 


COUNT(colonne) 


Retourne le nombre de lignes dont la valeur n'est pas NULL dans la colonne 
precisee. COU NT ( * ) retourne le nombre total de lignes, meme si certaines ont la 
valeur NULL. 


COUNKDISTINCT colonne) 


Retourne le nombre de lignes ayant une valeur non NULL et distincte (en elimi- 
nant les doublons). 


MAX(colonne) 


Retourne la valeur maximale de la colonne precisee. 


MIN(colonne) 


Retourne la valeur minimale de la colonne precisee. 


SUM(colonne) 


Retourne la somme des valeurs de la colonne precisee. 



Exemples 

Pour calculer l'age moyen des clients : 

SELECT AVG(age)FROM client 

Vous obtenez la valeur 32.8182. 

Pour calculer le nombre de clients ayant indique leur adresse e-mail (done le nombre de 
lignes pour lesquelles la colonne mai 1 n'est pas NULL) : 

SELECT COUNTCmail )FR0M client 

Vous obtenez la valeur 9, alors qu'il y a 1 1 clients dans la table. 

Pour calculer le nombre total de clients : 

SELECT C0UNT(nom)FR0M client 

Vous obtenez la valeur 11. Vous auriez pu appliquer la fonction COUNTO a n'importe 
quelle colonne ayant l'attribut NOT NULL et obtenir le meme resultat. 

Pour calculer le nombre de villes differentes de la table cl ient : 

SELECT COUNTtDISTINCT ville)FROM client 
Vous obtenez la valeur 7. 
Pour determiner le prix maximal de la table artl cl e : 

SELECT MAX(prix)FROM article 
Vous obtenez la valeur 2399.00. 
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Pour determiner l'age du client le plus jeune : 

SELECT MIN(age)FROM client 
Vous obtenez la valeur 18. 
Pour calculer le nombre total d'articles commandes : 

SELECT SUM(quantite)FROM ligne 
Vous obtenez la valeur 51. 

Le regroupement 

La clause GROUP BY utilisee dans une commande SELECT permet de regrouper des lignes 
ayant une caracteristique commune. Vous obtenez de la sorte des sous-ensembles de 
lignes de la table auxquels vous pouvez appliquer des operations telles que les fonctions 
statistiques detaillees precedemment. Les calculs sont effectues sur ces sous-ensembles. 

Vous pouvez, par exemple, regrouper les clients par ville en ecrivant la clause ' GROUP BY 
vi 1 1 e ' . Au lieu de calculer l'age moyen de la totalite des clients, vous pouvez ainsi calcu- 
ler l'age moyen des clients par ville. 

La requete suivante : 

SELECT AVG( age ) AS 'age moyen', ville FROM client GROUP BY ville 

affiche le resultat ci-dessous, dans lequel l'utilisation d'un alias pour la colonne AVG(age) 
donne une information plus lisible en remplacant le nom de la colonne age par le texte age 

moyen. 



age moyen 


uille 


22.0000 


Chartres 


18.0000 


Lille 


48.5000 


Lyon 


37.0000 


Nantes 


36.0000 


Orleans 


29.3333 


Paris 


45.0000 


Versailles 



Les exemples precedents d' utilisation de fonctions statistiques n'utilisaient pas la clause 
GROUP BY. II n'etait done pas possible de selectionner plusieurs colonnes dans une meme 
requete. Avec cette clause, vous pouvez regrouper les lignes par ville et afficher dans un 
meme tableau l'age minimal, l'age moyen et l'age maximal des clients. 

Par exemple, la requete suivante : 

SELECT MIN(age) AS 'Age minimum' ,AVG(age) AS 'Age moyen', MAX(age) AS 
*» 'Age maximum' , ville 
FROM client 
GROUP BY ville 

retourne le tableau illustre a la figure 14-19. 
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Age minimum 


Age moyen 


Age 


maximum 


uille 


22 


22.0000 




22 


Chartres 


18 


18.0000 




18 


Lille 


45 


48.5000 




52 


Lyon 


37 


37.0000 




37 


Nantes 


36 


36.0000 




36 


Orleans 
Paris 


19 


29.3333 




44 


45 


45.0000 




45 


Versailles 



Figure 14-19 

Calculs statistiques sur les ages 

Exemple 

Pour afficher le montant total et le nombre d' articles de chaque commande, vous allez 
utiliser la colonne id_comm comme critere de regroupement. En appliquant la fonction 
SUMO, vous pouvez calculer le prix de chaque ligne puis le total : 

SELECT id_comm AS 'Numero de commande', 

SUM( prixunit * quantite ) AS 'Prix Total', SUM(quantite) AS 'Nombre d\ 'articles' 

FROM ligne 

GROUP BY id_comm 

La requete affiche le resultat illustre a la figure 14-20. 



Numero de commande 


Prix Total 


Hombre d'articles 




1 


1709.70 


4 




2 


3000.00 


2 




3 


2395.00 


5 




4 


7232.00 


5 




5 


329.00 


1 




6 


1570.70 


4 




7 


9995.00 


5 




8 


3889.00 


2 




9 


269.00 


1 




10 


5429.00 


3 




11 


175.00 


10 




12 


4994.60 


7 




13 


3998.00 


2 



Figure 14-20 

Calcul du prix total par commande 
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Dans un regroupement, vous pouvez indiquer une condition de restriction des lignes, 
comme dans une requete de selection habituelle. Vous utilisez pour cela la clause HAVING, 
qui est l'equivalent de la clause WHERE mais n'est utilisee qu'apres une clause GROUP BY. 
Les conditions ecrites dans HAVING peuvent utiliser les memes operateurs et fonctions que 
celles ecrites dans WHERE. 

Par exemple, pour calculer l'age moyen des clients qui habitent des villes dont l'initiale 
estL, vous ajoutez une condition de restriction HAVING al'aidedel'operateur LIKE apres la 
clause GROUP BY. 

La requete suivante : 

SELECT AVG( age ),ville 
FROM client 
GROUP BY ville 
HAVING ville LIKE '1%' 

affiche le resultat ci-dessous : 



AVG( age ) ville 

18.0000 Lille 
48.5000 Lyon 



Les jointures 

Faire une jointure consiste a effectuer une selection de donnees sur plusieurs tables. II 
faut pour cela que les tables concernees par la jointure aient au moins chacune une 
colonne contenant un meme type d' information. C'est le cas des tables cl ient et commande 
de la base magasin, qui ont en commun la colonne id_client. La commande SELECT peut 
done s'appliquer, avec une condition WHERE, a cette colonne. 

La syntaxe la plus courante d'une jointure est la suivante : 

I SELECT coll,col2,... 
FROM tablel,table2,... 
WHERE condition_de_jointure 

La condition de jointure est de la forme : 

| tablel.colX = table2.colY 

dans laquelle colX et colY contiennent des donnees representant la meme information, 
comme l'identifiant de client. 

Jointure de deux tables 

L'association entre un numero de commande et le nom d'un client fait intervenir les 
tables cl ient et commande. Pour retrouver toutes les commandes faites par un client, vous 
operez une jointure entre ces tables en utilisant la colonne id_cl ient commune aux deux 
tables. 
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La requete suivante : 

I SELECT commande.id_comrn,noni,prenoiTi,vil le 
FROM commande, 'client' 
WHERE cl ient.id_cl ient = commande. id_cl lent ORDER BY nom 

affiche le resultat illustre a la figure 14-21 (la clause ORDER BY trie les noms par ordre 
alphabetique). 



id_comm 


nom 


prenom 


uille 




2 


Basile 


Did 


Nantes 




5 


Basile 


Did 


Nantes 




13 


Basile 


Did 


Nantes 




6 


Dare 


Jeanne 


Paris 




4 


Devos 


Marie 


Lille 




9 


Gate 


Bill 


Lyon 




12 


Grave 


Nuyen 


Lille 




1 


Grave 


Nuyen 


Lille 




10 


Hochon 


Paul 


Chartres 




11 


Mac Neal 


John 


Lyon 




3 


Marti 


Jean 


Orleans 




3 


Marti 


Pierre 


Paris 




7 


Rapp 


Paul 


Paris 



Figure 14-21 

Jointure sur les tables client et commande 

La condition WHERE peut comporter d'autres composantes permettant d'operer une selec- 
tion plus precise. 

Par exemple, pour selectionner les commandes du client dont l'identifiant est 5, vous 
ajoutez la condition suivante a la clause WHERE : 

I SELECT commande. id_comm, cl ient. id_cl ient FROM commande, cl ient 
WHERE cl ient. id_cl ient = commande. id_cl ient AND cl ient. id_cl ient =5 

Cette requete affiche le resultat ci-dessous : 



id_comm 


id 


_client 


date 


1 




5 


2004-06-11 


12 




S 


2005-02-01 



II est possible d'utiliser la clause GROUP BY dans une jointure pour effectuer des calculs 
statistiques sur un groupe de donnees. 
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Dans l'exemple suivant, vous cherchez a etablir la liste des articles les plus vendus sur le 
site et a afficher leur code, leur designation, leur prix et le nombre total d' articles. Vous 
effectuez pour cela une jointure sur les tables arti cl e et 1 i gne en utilisant comme critere 
de jointure leur colonne commune 1d_art1cle. Vous appliquez ensuite a la colonne id_ 
articl e la clause GROUP BY pour obtenir la somme des ventes de chaque article et la clause 
ORDER BY pour afficher les resultats en ordre decroissant : 

SELECT article. id_article, designation, prix SUM( quantite ) AS 'Total' 

FROM article.1 igne 

WHERE article. id_article = 1 igne.id_article 

GROUP BY id_article 

ORDER BY Total DESC 

La requete affiche le resultat illustre a la figure 14-22. 



id_article 


designation 


prix 


Total 


DVD75 


DVD vierge par 3 


17.50 


12 
10 


CAS07 


Cassette DV60 par 5 


26.90 


SAX15 


Portable Samsung X1 5 XVM 


1999.00 


8 


CS330 


Camescope Sony DCR-PC330 


1629.00 


4 


SOXMP 


PC Portable Sony 11 -XMP 


2399.00 


4 


HP497 
CP100 


PC Bureau HP497 ecran TFT 


1500.00 


2 


Camescope Panasonic SV-AV 100 


1490.00 


2 


DEL30 


Portable Dell X300 


1715.00 


2 


NIK55 


Nikon F55+zoom 28/80 


269.00 


1 
1 


CA300 


Canon EOS 3000V zoom 28/80 


329.00 



Figure 14-22 

Jointure et groupement 



Jointure de plus de deux tables 

Les jointures peuvent porter sur plus de deux tables, a condition que les tables jointes 
contiennent un meme type de donnee dans une de leurs colonnes. 

L'exemple suivant est d'une forme plus complexe que les precedents car il opere successi- 
vement une jointure sur les tables commande et cl i ent ayant en commun la colonne i d_cl i ent 
et une jointure sur les tables commande et 1 i gne ayant en commun la colonne id_comm. 
Ces jointures permettent tout a la fois de selectionner les numeros des commandes, 
les nom, prenom et ville du client associe a la commande et le montant total de la 
commande obtenu et de regrouper les resultats par numero de commande a l'aide de 
la clause GROUP BY. 
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Le tri des donnees est effectue par le nom des clients de facon a voir d'un coup toutes les 
commandes d'un meme client : 

SELECT commande. id_comm, nom, prenom, ville, sum( quantite * prixunit ) 

*AS 'Prix total ' 

FROM commande, 'client' , ligne 

WHERE cl ient.id_cl ient = commande. i d_cl ient AND commande. id_comm = 1 igne.id_comm 

GROUP BY id_comm 

ORDER BY nom 

La requete afflche le resultat illustre a la figure 14-23. 



idcomm 


nom 


prenom 


ville 

Nantes 


Prix total 

329.00 


5 


Basile 


Did 


13 


Basile 


Did 


Nantes 


3998.00 


2 


Basile 


Did 


Nantes 


3000.00 


6 


Dare 


Jeanne 


Paris 


1570.70 


4 


Devos 


Marie 


Lille 


7232.00 


9 


Gate 


Bill 


Lyon 


269.00 


12 


Grave 


Nuyen 


Lille 


4994.60 


1 


Grave 


Nuyen 


Lille 


1709.70 


10 


Hochon 


Paul 


Chartres 


5429.00 


11 


Mac Neal 


John 


Lyon 


175.00 


3 


Marti 


Jean 


Orleans 


2395.00 


S 


Marti 


Pierre 


Paris 


3889.00 


7 


Rapp 


Paul 


Paris 


9995.00 



Figure 14-23 

Jointure sur trois tables 



Exercices 



Exercice 1 

Creez une base nommee voitures. Creez ensuite les tables de la base voitures selon le 
modele logique defini dans les exercices du chapitre 13. Omettez volontairement certaines 
colonnes, et faites quelques erreurs de type de colonne. Une fois les tables creees, ajoutez 
les colonnes manquantes, et corrigez les erreurs. Verifiez la structure de chaque table. 

Exercice 2 

Exportez les tables de la base voitures dans des fichiers SQL. 
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Exercice 3 

Supprimez toutes les tables de la base voitures. 

Exercice 4 

Recreez les tables de la base voitures en utilisant les fichiers SQL precedents. 

Exercice 5 

Inserez des donnees dans la table proprietaire de la base voitures, puis verifiez-en la 
bonne insertion. 

Exercice 6 

Creez un fichier texte contenant une liste de modeles de voitures avec autant de donnees 
par ligne que de colonnes dans la table model e de la base voitures. Inserez ces donnees 
dans la base. 

Exercice 7 

Creez un fichier Excel ou OpenOffice contenant une liste de modeles de voitures avec 
autant de donnees par ligne que de colonnes dans la table model e. Enregistrez-le au format 
CSV, et inserez les donnees dans la base. 

Exercice 8 

Inserez des donnees dans les autres tables de la base voitures. Effectuez des mises a jour 
en modifiant certaines valeurs. 

Exercice 9 

Dans la base magasi n, selectionnez les articles dont le prix est inferieur a 1 500 euros. 

Exercice 10 

Dans la base magasi n, selectionnez les articles dont le prix est compris entre 100 et 
500 euros. 

Exercice 1 1 

Dans la base magasi n, selectionnez tous les articles de marque Nikon (dont la designation 
contient ce mot). 

Exercice 12 

Dans la base magasi n, selectionnez tous les camescopes, leur prix et leur reference. 

Exercice 13 

Dans la base magasi n, selectionnez tous les produits de la categorie informatique, et affi- 
chez leur code, leur designation et leur prix par ordre decroissant de prix. 

Exercice 14 

Dans la base magasi n, selectionnez tous les clients de moins de 40 ans, et ordonnez les 
resultats par ville en ordre alphabetique. 
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Exercice 15 

Dans la base magasin, calculez le prix moyen de tous les articles. 

Exercice 16 

Dans la base magasin, calculez le nombre d'e-mails non NULL et distincts l'un de l'autre. 

Exercice 17 

Dans la base magasin, affichez les coordonnees des clients ayant la meme adresse (meme 
adresse et meme ville). 

Exercice 18 

Dans la base magasin, selectionnez tous les articles commandes par chaque client. 

Exercice 19 

Dans la base magasin, selectionnez tous les clients dont le montant d'une commande 
depasse 1 500 euros. 

Exercice 20 

Dans la base magasin, selectionnez tous les clients dont le montant total de toutes les 
commandes depasse 5 000 euros. 

Exercice 21 

Dans la base voitures, selectionnez tous les vehicules d'une personne donnee. 

Exercice 22 

Dans la base voitures, selectionnez toutes les personnes ayant le meme modele de 
voiture. 

Exercice 23 

Dans la base voitures, selectionnez tous les vehicules ayant plusieurs coproprietaires. 
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Acces procedural a MySQL 

avec PHP 



Ayant acquis au chapitre precedent une maitrise des commandes SQL, vous pouvez abor- 
der les fonctions PHP permettant d'acceder a une base MySQL a partir d'un script PHP, 
d'y inserer des donnees et d'utiliser ces donnees pour creer des pages dynamiques. 

Pour que la base de donnees MySQL soit accessible a partir des pages d'un site, il faut 
pouvoir l'utiliser par 1' intermediate d'un script. MySQL est utilisable par d'autres 
langages que PHP, Java par exemple. Le couple PHP-MySQL est cependant le plus 
repandu sur le Web. 

L'acces a une base MySQL et son utilisation, qu'il s'agisse d'inserer, de modifier ou de 
lire des donnees, suit les etapes ci-dessous : 

1. Connexion au serveur MySQL. 

2. Envoi de diverses requetes SQL au serveur (insertion, lecture, suppression ou mise a 
jour des donnees). 

3. Recuperation du resultat d'une requete. 

4. Fermeture de la connexion au serveur. 

Le present chapitre montre comment effectuer ces etapes au moyen des nombreuses 
fonctions proposees par l'extension mysql dont vous pouvez verifier la presence au 
moyen de la fonction phpinfo( ). Celle-ci donne acces a MySQL de maniere procedurale. 
Les chapitres suivants sont consacres a l'acces a MySQL au moyen d'objets. 
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Connexion au serveur MySQL 

Avant toute chose, le script doit permettre de se connecter au serveur MySQL. La fonc- 
tion essentielle de ce script est mysql_connect( ), dont la syntaxe est la suivante : 

resource mysql_connect (string $host , string $user , string $pass [, bool $multi]) 

$host est une chaine contenant le nom du serveur. Ce dernier est defini par l'hebergeur du 
site et est communique lors de la souscription de l'abonnement. II s'agit le plus souvent 
de la chaine "local host", comme ce sera le cas dans tous les exemples de ce chapitre, 
realises en local avec Wampserver. 

$user est le nom sous lequel l'utilisateur est autorise a acceder au serveur. II s'agit 
generalement du nom de domaine ou du login pour les hebergements gratuits. Dans 
Wampserver, la valeur par defaut de ce parametre est "root". $pass est le mot de passe 
associe a l'utilisateur. Si plusieurs utilisateurs sont autorises a acceder au serveur, chacun 
doit posseder un identiflant et un mot de passe personnel. Sur un serveur local, il s'agit 
par defaut d'une chaine vide. 

$multi est un booleen. S'il vaut TRUE, deux appels de mysql^connectO avec des parametres 
identiques dans un meme script creent deux connexions differentes. 

Par mesure de securite, vous avez tout interet a placer les valeurs des parametres de 
connexion dans un fichier separe, en prenant soin d'y definir ces parametres sous forme 
de constantes. Vous pouvez ensuite l'inclure dans les scripts de creation de connexions 
utilisant les noms de ces constantes. Le fichier myparam.inc.php de l'exemple 15-1 realise 
cette operation avec ici les parametres du serveur local. Vous l'utiliserez systematique- 
ment par la suite. 

*~ Exemple 1 5-1 . Le fichier myparam.inc.php 

<?php 

define("MYHOST","localhost"); 

define("MYUSER","root"); 

defineC'MYPASS",""); 

?> 

La fonction mysql_connect( ) retourne une variable de type resource, qui est un identifiant 
de connexion. II faut recuperer cette valeur dans une variable car elle est utilisee pour 
effectuer les operations suivantes sur la base. L' identifiant est note systematiquement 
Sidcomm dans les exemples de ce chapitre. Si la connexion n'est pas etablie, la fonction 
retourne FALSE. Vous devez done tester la reussite de la connexion avant d'effectuer 
d'autres operations. 

La connexion au serveur peut egalement etre etablie a l'aide de la fonction mysql_ 
pconnectO, qui requiert les memes parametres que mysql_connect() mais etablit une 
connexion persistante. Certains hebergeurs interdisant l'usage de cette fonction, vous ne 
l'utiliserez pas dans ces exemples. 

La connexion etablie prend fin automatiquement quand le script PHP est termine. II est 
cependant recommande d'y mettre fin explicitement des que possible de facon a liberer 
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le serveur MySQL. Le script peut en effet realiser toutes sortes d'operations qui ne neces- 
sitent pas de connexion. Cette precaution ameliore la vitesse des connexions des autres 
utilisateurs. 

Pour mettre fin a la connexion, vous appelez la fonction mysql_close( ), dont la syntaxe 
est la suivante : 

boolean mysql_close([$idcom]) 

Le parametre $idcom est l'identifiant de connexion recupere lors de la connexion. S'il est 
omis, c'est la derniere connexion utilisee qui est fermee. Une connexion persistante ne 
peut etre fermee par la fonction mysql_cl ose( ). 

Si le serveur comporte plusieurs bases de donnees, le script precise la base desiree au 
moyen de la fonction mysql^sel ect_db( ), dont la syntaxe est la suivante : 

boolean mysql_select_db($nom_base [,$idcom]) 

Cette fonction retourne TRUE si la base existe et FALSE dans le cas contraire. Apres l'appel 
de cette fonction, toutes les requetes SQL envoyees au serveur MySQL sont effectuees 
sur la base choisie, sans qu'il soit besoin de le preciser. 



La commande USE 

Vous pouvez utiliser a la place de la fonction PHP mysql_sel ect_db( ) la commande SQL USE, selon la 
syntaxe USE nom_base, en passant la chaine "USE nom_base" comme parametre a la fonction my sql_ 
query( ), detaillee a la section suivante. 



Si le script effectue de nombreuses operations entre deux requetes, il est bon de verifier 
que la connexion est toujours active. Le serveur met fin a une connexion apres un delai 
defini par defaut dans le fichier php.ini a trente secondes sur Wampserver et variable 
selon l'hebergeur du site. 

Vous disposez de la fonction mysql_ping( ) pour verifier que la connexion est active. La 
syntaxe de cette fonction est la suivante : 

boolean mysql_ping(resource $idcom) 

La fonction retourne TRUE si la connexion est active et FALSE dans le cas contraire. Si la 
connexion est fermee, il y a automatiquement reconnexion au serveur avec les parame- 
tres utilises par la fonction mysql_connect( ). 

La structure d'un script accedant au serveur MySQL est la suivante : 

<?php 

//Inclusion des parametres de connexion 
incl ude_once("myparam.inc.php") ; 
//Connexion au serveur 

$idcom=@mysql_connect(MYHOST,MYUSER,MYPASS); 
//Choix de la base 
$idbase=@mysql_select_db($base) ; 
//Affichage d'un message en cas d'erreurs 
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if ( !$idcom| !$idbase) 
{ 

echo "<script type=text/javascript>" ; 

echo "alert( 'Connexion Impossible a la base $base' )</script>" ; 

} 
//•it****************************** 

//Requetes SQL sur la base choisie 
//******************************** 

//Fermeture de la connexion 

mysql_close($idcom) ; 

?> 

Lorsque les scripts du site doivent acceder frequemment au serveur MySQL, vous avez 
interet a creer une fonction specialisee, dont l'appel evite de reecrire ces parties de code. 
L'exemple 15-2 cree une telle fonction en utilisant deux parametres, $base, qui est le nom 
de la base a laquelle vous souhaitez acceder, et $param, qui est le nom du fichier contenant 
les parametres de connexion sans les extensions .inc.php. Elle peut etre utilisee dans 
plusieurs sites differents car elle est independante aussi bien du nom du serveur que de 
celui de la base. 

La fonction inclut d'abord les parametres de connexion (repere ©) puis appelle la fonc- 
tion mysql_connect() en utilisant ces parametres (repere©). Elle selectionne ensuite la 
base (repere©) et gere les erreurs eventuelles de connexion ou d'acces a la base 
(repere ©) en affichant une boite d'alerte en JavaScript (repere ©). La fonction retourne 
enfin l'identifiant de connexion $idcom (repere ©). L'utilisation du caractere @ devant le 
nom des fonctions permet d'eviter l'affichage des eventuels messages d'erreur sur la page. 

Exemple 15-2. Fonction de connexion au serveur 

<?php 

function connex($base,$param) 



{ 



include_once($param. " .inc.php") ; <— © 

$idcom=@mysql_connect(MYHOST,MYUSER,MYPASS) ; <-© 

$idbase=@mysql_select_db($base) ; <— © 

if(!$idcom | !$idbase) <-© 

{ 
echo "<script type=text/javascript>" ; <— © 
echo "alertt 'Connexion Impossible a la base Sbase' )</script>" ; 

} 

return $idcom; <— © 
} 
?> 

Chacun de vos scripts d'acces a une base de donnees doit done contenir les lignes de code 
suivantes, qui permettent d'utiliser la fonction connex( ) apres avoir inclus son code : 

Iincl udeC'connex. inc.php") ; 
$idcom=connex("nom_base" , "my pa ram") ; 



Cela allege d'autant chacun des scripts. 
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Envoi de requetes SQL au serveur 

Toute operation a realiser sur une base necessite d'envoyer au serveur une requete SQL 
redigee a l'aide des commandes detaillees au chapitre precedent. 

Pour envoyer une requete, vous utilisez d'abord la fonction mysql_query( ), dont la syntaxe 
est la suivante : 

resource mysql_query(string $requete [.resource $idcom][ ,int mode]) 

La chaine $ requete contient le code de la requete SQL. Elle ne doit pas se terminer par un 
point- virgule. Les requetes etant souvent longues, il est recommande, a des fins de lisibi- 
lite du code, de les ecrire dans une variable chaine $ requete passee ensuite a la fonction. 

$idcom est l'identifiant de connexion. II est facultatif si une seule connexion est ouverte. 
mode est une constante entiere, qui prend les valeurs MYSQL_STORE_RESULT (valeur par 
defaut) si le resultat de la requete doit etre mis en buffer (memoire tampon sur le serveur) 
et MYSQL_USE_RESULT dans le cas contraire. Dans ce dernier cas, il faut lire le resultat avant 
d'envoyer une nouvelle requete au serveur, faute de quoi le resultat est perdu. 

La fonction retourne un identifiant de resultat de type resource, note systematiquement 
$result dans ces exemples. Si la requete contient des commandes SELECT, cet identifiant 
permet d' acceder aux donnees fournies par la requete en utilisant certaines fonctions PHP 
que vous decouvrirez plus loin dans ce chapitre. Pour les autres requetes (suppression, 
modification, mise a jour), la fonction retourne TRUE si la requete est bien executee. Si une 
requete quelconque n'est pas executee, la fonction mysql„query() retourne FALSE. II est 
recommande d'effectuer un test pour verifier la bonne realisation de chaque requete SQL 
dans un script. 

Un script d'envoi de requete a la forme suivante : 

<?php 

incl udeC'connex.inc.php") ; <— © 

$idcom=connex( "magasin" , "myparam") ; <— © 

$requete="SELECT * FROM article ORDER BY categorie" ; <— © 

$ res ul t=@mysql_query($ requete, $idcom) ; <— © 

if(!$result) 

{ 

echo "Lecture impossible" ; <— © 
} 

else 
{ 
//Lecture des resultats eventuels de la requete <— © 

} 

?> 

II effectue successivement l'inclusion du fichier connex.inc.php (repere ©), la connexion 
au serveur grace a la fonction connexO (repere ©), l'ecriture de la requete (repere ©), 
l'envoi de la requete et la recuperation du resultat (repere ©) et enfin l'affichage d'un 
message d'erreur eventuel si la requete n'a pas abouti (repere ©) et celui des resultats de 
la requete (repere ©). Nous verrons, dans les sections suivantes, comment afficher les 
resultats d'une requete de selection. 
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Lecture du resultat d'une requete 

Pour les operations d'insertion, de suppression ou de mise a jour de donnees dans une 
base, il est simplement utile de verifier si la requete a bien ete executee. 

Par contre, lorsqu'il s'agit de lire le resultat d'une requete contenant la commande SELECT, 
il est indispensable de recueillir les donnees. PHP offre une grande variete de fonctions 
qui permettent de recuperer des donnees sous des formes diverses, la plus courante etant 
un tableau. Chacune de ces fonctions ne recuperant qu'une ligne du tableau a la fois, il 
faut recourir a une ou plusieurs boucles pour lire 1' ensemble des donnees. 

Lecture a I'aide d'un tableau 

La fonction la plus perfectionnee pour lire les donnees dans un tableau est mysql_fetch_ 
array ( ). Sa syntaxe est la suivante : 

j array mysql_fetch_array( resource $result [,int typetab]) 

Cette fonction retourne un tableau contenant autant d' elements qu'il y a de colonnes 
precisees dans la requete SELECT. Le parametre $result est celui qui a ete retourne par la 
fonction mysql jueryO, et le parametre typetab une constante entiere precisant si le 
tableau retourne doit etre associatif (valeur MYSQL_ASSOC), indice (valeur MYSQL_NUM) ou les 
deux a la fois (valeur MYSQLJOTH, qui est la valeur par defaut). Si le tableau est associatif, 
les cles du tableau sont les noms des colonnes de la table interrogee ou des alias, si vous 
en avez definis dans la requete. II n'est done pas necessaire de connaitre l'ordre des 
colonnes dans la table. 

Si le tableau est indice, l'indice d'un element est celui de la colonne dans la requete, la 
premiere colonne ayant l'indice 0. Pour recuperer la valeur d'une colonne precise, il est 
indispensable de connaitre sa position dans la requete. 

Chaque nouvel appel de la fonction mysql_fetch_array() retourne la ligne suivante du 
resultat identifie par $result, ou FALSE s'il n'y a plus de ligne a lire. II faut effectuer une 
boucle pour lire chacune des lignes puis une autre boucle imbriquee dans la premiere 
pour lire chacune des valeurs des colonnes de la table. 



Nombre de lignes et de colonnes d'un resultat 

La fonction int mysqljurrufi elds (resource $idresult) permet de determiner le nombre de 
colonnes du resultat et la fonction int mysql_num_rows( resource Sidresult) le nombre de lignes. 



L'exemple 15-3 met en pratique les techniques que vous venez d'aborder en effectuant la 
lecture de la table article de la base magasin creee au chapitre 14. Apres l'appel de la 
fonction de connexion (repere Q). l'ecriture de la requete SQL (repere ©) et son envoi 
au serveur, le resultat est identifie par la variable $result (repere ©). Le script controle 
ensuite si le resultat est valide (repere ©) et lit le nombre de colonnes et de lignes 
retourne par la requete (repere et ©). La premiere boucle whi 1 e de lecture du resultat 
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retourne une ligne a la fois dans un tableau indice (repere ©), puis une boucle foreach lit 
chacune des valeurs du tableau et realise un affichage dans un tableau XHTML 
(repere @). La ressource $resul t est ensuite liberee (repere ©). 



Liberation de la memoire 

Une fois les donnees utilisees pour realiser un affichage dans une page XHTML, il est possible de liberer 
la memoire occupee par la variable $result en appelant la fonction mysql_free_result ($result). 
Cette derniere retourne TRUE en cas de reussite et FALSE dans le cas contraire. Cette operation ne doit 
etre faite que si vous n'avez plus besoin des donnees dans le script. 



La figure 15-1 illustre la page realisee par ce script. 
Exemple 15-3. Lecture de la table article 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture de la table article</title> 
<style type="text/css" > 

table (border-style :double;border-width:3px; border-col or: red; 
^►background-col or: yellow; } 
</style> 
</head> 
<body> 
<?php 

incl udeC'connex.inc.php") ; 
$idcom=connex( "magasin" , "myparam") ; <— O 
$requete="SELECT * FROM article ORDER BY categorie" ; <— © 
$result=@mysql_query($requete,$idcom) ; <— © 
if(!$result) <-© 
{ 

echo "Lecture impossible"; 



$nbcol =my sql_num_fi el ds($ result) ; <— © 

$nbart=mysql_num_rows($ result) ; <— © 

echo "<h3> Tous nos articles par categorie</h3>" ; 

echo "<h4> II y a $nbart articles en magasin </h4>"; 

echo "<table border=\"l\"Xtbody>"; 

echo "<tr><th>Code article</th> <th>Description</th> <th>Prix</th> 

••<th>Categorie</th></tr>" ; 

while($ligne=mysql_fetch_array($result,MYSQL_NUM)) <— © 

{ 

echo "<tr>"; 

foreach($ligne as $valeur) <— © 
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echo "<td> Svaleur </td>"; 

} 

echo "</tr>"; 

} 

echo "</tbody></table>"; 
} 

mysql_f ree_result($result) ; <— ® 
?> 

</body> 
</html> 
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Figure 15-1 

Lecture de la table article 



Les deux autres fonctions suivantes permettent de recuperer une ligne de resultat a la fois 
dans un tableau : 

• array mysql_fetch_assoc( resource $result), qui retourne un tableau uniquement asso- 
ciatif dont les cles sont les noms des colonnes de la table interrogee. 

• array mysql_fetch_row( resource $ result), qui retourne un tableau uniquement indice 
dont les indices sont les numeros des colonnes dans la table interrogee. 

Ces fonctions peuvent s'utiliser en lieu et place de mysql_fetch_array() avec la meme 
rapidite. 
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Lecture des noms de colonnes 

Si vous choisissez de recuperer les lignes du resultat dans un tableau associatif, vous 
pouvez lire les noms des colonnes pour les afficher dans la page XHTML. Si vous utili- 
sez de plus des alias dans la requete SQL, vous pouvez donner aux noms des colonnes 
des titres plus significatifs que id_article sans avoir a les ecrire explicitement dans le 
code de creation du tableau XHTML, a la difference de l'exemple precedent. 

II existe deux methodes pour lire les noms des colonnes d'une table. 

Premiere methode 

L'exemple 15-4 illustre une requete SQL selectionnant tous les articles de marque Sony en 
definissant des alias pour les noms de colonnes (repere 0). Apres l'envoi de la requete par 
la fonction mysql„query() (repere©), un premier appel a la fonction mysql_fetch_array() 
lit la premiere ligne du resultat dans un tableau associatif (repere 0). Une boucle f oreach 
lit les cles du tableau obtenu et affiche les titres des colonnes du tableau (repere 0). 

A ce stade, la variable Sligne contient la premiere ligne de resultat, mais vous n'avez 
utilise que les cles de ce tableau, qui sont les noms des colonnes. Si vous lisiez les valeurs 
des lignes avec une boucle while, comme a l'exemple precedent, un nouvel appel de la 
fonction mysql_fetch_array() lirait la deuxieme ligne, ce qui ecraserait les valeurs de 
la premiere ligne. L'emploi d'une boucle do.. while resout ce probleme, la fonction 
mysql_fetch_array() n'etant appelee qu'apres l'affichage des valeurs de chaque ligne 
(reperes et 0). 

*" Exemple 15-4. Recuperation des noms de colonnes 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture de la table article</title> 
<style type="text/css" > 

table {border- sty 1 e :double;border-width:3px; border-col or: red; background-col or :yel low; } 
</style> 
</head> 
<body> 
<?php 

incl udeC'connex.inc.php") ; 
$idcom=connex( "magasin" , "myparam") ; 

$requete="SELECT id_article AS 'Code article' .designation AS 'Designation' ,prix 
^»AS 'Prix Unitaire' .categorie AS 'Categorie' 
FROM article 

WHERE designation LIKE '%Sonyr 
ORDER BY categorie"; <— Q 
$result=@mysql_query($requete,$idcom) ; <— 
1f(!$result) 
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echo "Lecture impossible"; 



else 
{ 

$nbart=mysql_num_rows($ result) ; 

$ligne=mysql_fetch_array($result,MYSQL_ASSOC); <— Q 

echo "<h3> Tous nos articles de la marque Sony</h3>"; 

echo "<h4> II y a $nbart articles en magasin </h4>"; 

echo "<table border=\"l\"> <tr>"; 

foreach($ligne as $nomcol=>$valcol ) <— © 

{ 
echo "<th> $nomcol </th>"; 

} 

echo "<tr>"; 

do <— 

{ 
echo "<tr>"; 

foreach($l igne as $valcol) 
{ 

echo "<td> Svalcol </td>"; 
} 

echo "</tr>"; 
} 

while($ligne=mysql_fetch_array($result,MYSQL_NUM)); <— © 
echo "</table>"; 
} 

?> 

</body> 
</html> 

La figure 15-2 illustre les resultats de la requete effectuee sur la table arti cl e. 
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Deuxieme methode 



II existe une autre methode pour lire le nom des colonnes du resultat d'une requete 
SELECT. La fonction mysql_field_name( ), dont la syntaxe est la suivante : 

string mysql_fi el d_name( resource Sresult, int num_col) 

retourne le nom de la colonne ou de 1' alias dont le numero est passe en second parametre. 
L'ordre des colonnes est celui de la requete et done pas necessairement celui de la table. 

L'exemple 15-5 illustre cette possibilite de lecture des noms des colonnes. La requete 
SQL selectionne les caracteristiques des clients habitant a Paris (repere Q). Apres l'envoi 
de celles-ci (repere @), vous recuperez le nombre de colonnes (repere ©) et de lignes 
(repere ©) du resultat. Une boucle for permet l'affichage des en-tetes du tableau 
XHTML (repere ©). La fonction mysql_f iel d_name( ) permet de lire le nom des colonnes 
(repere ©). 

Pour afficher les valeurs selectionnees, vous creez une boucle for (repere ©), dans 
laquelle vous lisez une ligne du resultat en appelant la fonction mysql_fetch_row() 
(repere©). Une autre boucle for imbriquee dans la precedente permet l'affichage de 
toutes les valeurs d'une ligne contenues dans le tableau $1 i gne (repere 0). 

L'avantage de ces methodes est d'automatiser l'ecriture des en-tetes du tableau XHTML, 
et ce quel que soit le nombre de colonnes selectionnees. Si vous ajoutez le champ mail 
dans la requete, il n'y a qu'une ligne a modifier alors qu'avec la methode de l'exem- 
ple 15-3, il faudrait modifier tout le code de creation des en-tetes. 

La figure 15-3 donne un apercu du resultat obtenu en ajoutant simplement le champ mail 
a la requete. 

Exemple 15-5. Lecture des noms de colonnes 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture de la table cl ient</title> 
<style type="text/css" > 

table {border-style:double;border-width: 3px;border-color: red; 
*»background-color: yellow;} 
</style> 
</head> 
<body> 
<?php 

incl udeC'connex.inc.php") ; 
$idcom=connex( "magasin" , "myparam") ; 

$requete="SELECT id_client AS 'Code client' , nom, prenom.adresse, age 
FROM client 
WHERE ville ='Paris' 
ORDER BY nom"; <-© 
$result=@mysql_query($requete,$idcom) ; <— © 
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if(!$result) 
{ 

echo "Lecture impossible"; 
} 

else 
{ 
$nbcol=mysql_num_fi el ds($ result) ; <— | 

$nbart=mysql_num_rows($result) ; <— ( 

echo "<h3> II y a $nbart clients habitant Paris</h3>"; 

//Affichage des titres du tableau 

echo "<table border=\"l\"> <tr>"; 

for($i=0;$i<$nbcol ;$i++) <— © 
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echo "<th>", mysql_field_name($result,$i ) ," </th>";<— © 
} 

echo "</tr>"; 

//Affichage des valeurs du tableau 
for($i=0;$i<$nbart;$i++) <— © 



$1 igne=mysql_fetch_row($ result) ; <— @ 
echo "<tr>"; 

for($j=0;$j<$nbcol ;$j++) <-0 
{ 

echo "<td>",$ligne[$j],"</td>"; 
} 

echo "</tr>"; 
} 

echo "</table>"; 
mysql_f ree_result($result) ; 
} 

?> 

</body> 
</html> 
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Figure 15-3 

Affichage automatique des en-tetes de tableau XHTML 
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Utilisation d'un objet 

A I'exemple 15-5, I'appel de la fonction mysql_field_name($result,$i ) pourrait etre remplace par 
mysql_fetch_field($result,$i)->name. Cette derniere fonction, ayant pour syntaxe object 
mysql_fetch_field($result,$i ), retourne un objet dont la propriete name contient le nom de la 
colonne dont la position est precisee par I'entier $ i . 



Recuperation des valeurs dans un objet 

Vous pouvez recuperer non settlement le nom de chaque colonne, comme en appelant 
la fonction mysq1_fetch_f1 el d( ) , mais egalement la valeur de chaque colonne d'un resul- 
tat sous la forme d'une propriete d'objet grace a la fonction mysql_fetch_object( ). 

La syntaxe de cette fonction est la suivante : 

object mysql_fetch_object( resource Sresult) 

L'objet retourne par cette fonction a autant de proprietes que la requete a selectionne de 
colonnes, les noms des proprietes etant ceux des colonnes ou des alias eventuels. 
L'exemple 15-6 realise le meme affichage que I'exemple 15-5 en utilisant cette fonction. 
Les seules differences resident dans l'utilisation de la fonction mysql_fetch_field() 
(repere Q) pour afficher les en-tetes du tableau XHTML puis de mysql_fetch_object( ) 
pour lire chacune des lignes du resultat (repere ©). 

Un nouvel appel de mysql_fetch_field() permet d'enregistrer le nom de chacune des 
proprietes de l'objet dans la variable Snomcol (repere ©), ce qui permet d'afficher toutes 
les donnees d'une ligne. La syntaxe $ligne->$norncol permet de lire chaque propriete de 
l'objet (repere ©). Le resultat affiche est identique a celui de la figure 15-3. 

*~ Exemple 15-6. Lecture des donnees au moyen d'un objet 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 
<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture de la table cl ient</title> 
<style type="text/css" > 

table {border-style :double;border-width:3px; border-col or: red; 
* background-col or: yellow; } 
</style> 
</head> 
<body> 
<?php 

incl udeC'connex.inc.php") ; 
$idcom=connex( "magasin" , "myparam") ; 

$requete="SELECT id_client AS 'Code client' , nom, prenom.adresse, age, mail 
FROM client 
WHERE ville ='Paris' 
ORDER BY nom"; 
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$result=@mysql_query($requete,$idcom) ; 

if(!$result) 

{ 

echo "Lecture impossible"; 
} 

else 
( 
$nbcol=mysql_num_fi el ds($ result) ; 
$nbart=mysql_num_rows($ result) ; 

echo "<h3> II y a $nbart clients habitant Pari s</h3>" ; 
//Affichage des titres du tableau 
echo "<table border=\"l\"> <tr>"; 
for($i=0;$i<$nbcol ;$i++) 
{ 

echo "<th>", mysql_fetch_field($result,$i )->name," </th>";<— O 
} 

echo "</tr>"; 

//Affichage des valeurs du tableau 
for($i=0;$i<$nbart;$i++) 
{ 
$ligne=mysql_fetch_object($result) ; <— © 
echo "<tr>"; 

for($j=0;$j<$nbcol ;$j++) 
{ 
$nomcol=mysql_fetch_field($result,$j)->name; <— © 
echo "<td>" ,$ligne->$nomcol ,"</td>"; <— © 
} 

echo "</tr>"; 
} 

echo "</table>"; 
mysql_free_resul t($resul t) ; 
} 

?> 

</body> 
</html> 



Insertion de donnees dans la base 

Un site interactif se doit de permettre aux utilisateurs d'effectuer des saisies de donnees 
dans un formulaire et de les enregistrer dans une base de donnees en vue d'une utilisation 
ulterieure. Les methodes d'insertion a partir de phpMyAdmin ne peuvent evidemment 
pas convenir dans ce cas car elles sont reservees a 1' administrate ur du site. 

En vous situant toujours dans la perspective de creation d'un site de commerce en ligne, 
vous allez envisager comment realiser la saisie puis l'insertion des coordonnees d'un 
visiteur dans la table cl i ent de la base magasi n. Vous lui permettrez par la suite d'effectuer 
une mise a jour de ses parametres personnels de facon que la base reste a jour, en cas de 
changement d'adresse, par exemple. 
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Insertion des donnees 



Comme vous l'avez vu au chapitre 6, consacre aux formulaires, l'outil de communica- 
tion essentiel entre le poste client et le serveur est le formulaire XHTML. Ce dernier 
permet la saisie de donnees et leur envoi vers le serveur, sur lequel un script PHP enre- 
gistre les valeurs saisies dans la base MySQL. 

Vous disposez deja de la fonction personnalisee de connexion connexO et de mysql_ 
queryO pour envoyer la requete. Seule la requete qui contient la commande SQL INSERT,qui 
va etre envoyee au serveur, distingue cette operation de celle de lecture des donnees. 

Le script de l'exemple 15-7 realise ce type d' insertion a partir d'un formulaire permettant 
a un client d'enregistrer ses coordonnees lors d'une commande. Comme ceux du chapi- 
tre 6, il commence par verifier l'existence des saisies obligatoires correspondant aux 
variables $_P0ST['nom'], $_POST[adresse] et $_POST[ville] (repere ©). 

Dans le cas oil une requete est formee en utilisant des saisies faites par l'utilisateur dans 
un formulaire, il est preferable d'utiliser un caractere d'echappement pour les caracteres 
speciaux des chaines recuperees dans le tableau $_P0ST, en particulier les guillemets, 
qui peuvent poser probleme. Vous disposez pour cela des fonctions mysql_escape_string( ) 
et mysql_real_escape_string( ), dont les syntaxes respectives sont les suivantes : 

I string mysql_escape_string(string $chaine) 
string mysql_real_escape_string(string $chaine[, resource $idcom]) 

La seconde presente l'avantage de tenir compte du jeu de caracteres utilise. Le jeu de 
caracteres utilise sur le client MySQL peut etre lu en appelant la fonction mysql_cl i ent_ 
encodingO, qui retourne ce code dans une chaine explicite, par exemple 'latinl'. Par 
precaution, il est preferable d'appliquer ces fonctions a chacune des variables recupe- 
rees plutot qu'a la chaine de requete dans son entier. Aucune de ces deux fonctions 
n'echappe les caracteres "%" et "_". 

Vous recuperez et protegez ensuite toutes les valeurs du tableau $_P0ST dans des variables 
de facon a obtenir un code plus court par la suite (reperes © a ©). 

La valeur "\N" represente la valeur NULL de la variable $id_cl i ent. Elle permet que la 
colonne id_client de la table client soit incrementee d'une unite a chaque nouvelle 
insertion car elle est declaree avec l'option AUTO_INCREMENT. 

La fonction mysql_insert_id( ), dont la syntaxe est la suivante : 

int mysql_insert_id([$idcom]) 

retourne la derniere valeur inseree dans une colonne ayant cette option AUTO_INCREMENT. Elle 
sert a dormer son numero au client pour qu'il puisse s'identifier lors d'une autre connexion. 

La requete SQL INSERT contenue dans la variable $ requete (repere Q) permet l'insertion 
de toutes ces valeurs dans la table cl ient. Dans le cas d'une commande INSERT, le resultat 
de la requete envoyee par la fonction mysql_query( ) n'est qu'une valeur booleenne TRUE 
ou FALSE selon que l'insertion a ete realisee ou non (repere ©). Elle vous permet d'affi- 
cher un message d'information indiquant la bonne execution de l'insertion. Le numero 
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attribue au client lui est alors communique dans une boite d'alerte JavaScript (voir 
repere © et figure 15-5). 

Exemple 15-7. Insertion des donnees avec un formulaire 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtrnlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Saisissez vos coordonnees</title> 
</head> 
<body> 

<form action^ "<?php echo $_SERVER[' PHP_SELF' ] ;?>" method="post" 
enctype="applicati on /x-www-form-url encoded "> 
<fieldset> 

<legend><b>Vos coordonnees</bX/legend> 
<table> 

<tr><td>Nom : </tdXtdXinput type="text" name="nom" size="40" maxlength="30"/> 
*</tdX/tr> 

<trXtd>Prenom : </tdXtdXinput type="text" name="prenom" size="40" 
*maxlength="30"/X/tdX/tr> 

<trXtd>Age : </td><td><input type="text" name="age" size="40" maxlength="2"/> 
*</tdX/tr> 

<trXtd>Adresse : </td><td><input type="text" name="adresse" size="40" 
*maxlength="60"/X/tdX/tr> 

<trXtd>Ville : </tdXtdXinput type="text" name="ville" size="40" maxlength="40"/> 
*</tdX/tr> 

<trXtd>Mail : </td><td><input type="text" name="mail" size="40" maxlength="50"/> 
*</tdX/tr> 
<tr> 

<td><input type="reset" value=" Effacer "></td> 
<td><input type=" submit" value=" Envoyer "></td> 
</tr> 
</table> 
</fieldset> 
</form> 
<?php 

incl ude( 'connex.inc.php' ) ; 

if(!empty($_POST['nom'])&& ! empty ($_P0ST[ 'adresse' ] )&& !empty($_POST[ ' vil le' ]) )<-© 
{ 

$id_client="\N"; <^@ 

$nom= $_P0ST['nom']; <— Q 

$prenom=$_POST['prenom']; <— © 

$age=$_POST['age'] : <— © 

$adresse=$_POST['adresse']; <^© 

$ville=$_POST['ville']; <-© 

$mail=$_POST['mail ']; ^© 

//Requete SQL 

$requete="INSERT INTO client VALUESt '$id_cl ient' , '$nom' , 'Sprenom' , '$age' , 

*'$adresse','$ville','$mail ')"; <— © 

$idcom=connex( 'magasin' , 'my pa ram' ) ; 
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$resul t=mysql_query($requete,$idcom) ; <— © 
mysql_close($idcom) ; 
ifUtresult) 
{ 
echo "<h2>Erreur d'insertion \n n' " ,mysql_errno( ) ," : " ,mysql_error( ) . "</h2>" ; 



echo "<script type=\"text/javascript\"> 
alertt'Vous etes enregistre Votre numero de client est : ". 
*»mysql_insert_id( ) . " ' )</script>" ; <— © 
} 
} 
} 

else {echo "Formulaire a completer!";} 
?> 

</body> 
</html> 

La figure 15-4 illustre la page de saisie. Un affichage du contenu de la table client a 
l'aide de phpMy Admin vous permettrait de controler la bonne insertion des donnees du 
formulaire. 



ffliSlHlflPllfflSWII^^ 




Fichier EcStion Affichage Favoris Outils ? 


.' 




Q Precetfente - jD Rechercher 


j> 


Ac-.^L-r .&) http://127.0.0.]/php5^C15mvsql/mysqlex7.php 


"|H°* 




















Nom: MacCariney 








Prenom: |Paul 








Age : |55 








ArJrRssfv AhhiRty RnarJ 








Ville : |London 








Mail : | scarab e@paul mac. uk| 








Efface r Envoys r ] 














« 


«] Termlne 4ft internet 





Figure 15-4 

Formulaire d'insertion 



Microsoft Enter net Explorer 



J\ 



v:us e'tes enregistre votre rumfro je -:!ler.c est : 37 



Figure 15-5 

Communication du numero de client dans une boite d'alerte 



PHP 5 



Mise a jour d'une table 

Pour assurer le meilleur service aux clients du site, il est important de leur permettre de 
modifier leurs coordonnees en cas de changement d'adresse ou de nom. L'exemple 15-8 
cree une page contenant un formulaire de saisie du code client dans une zone de texte. 
Vous pourriez tout aussi bien l'utiliser pour mettre a jour les tarifs de la table arti cl e. 

L'attribut action du formulaire renvoie le traitement des donnees au fichier mysqlex9.php, 
dont le code est donne a l'exemple 15-9. La page creee est illustree a la figure 15-6. 

<*" Exemple 15-8. Page de saisie du code client 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Modifiez vos coordonnees</title> 
</head> 
<body> 
<form action= "mysqlex9.php" method="post" 
*»enctype="application/x-www-form-urlencoded"> 

<fieldset> 

<legend><b>Saisissez votre code client pour modifier vos coordonnees</b> 

*</legend> 

<table> <tr> <td>Code client : </td> 

<td><input type="text" name="code" size="20" maxlength="10"/> </td></tr> 

<tr><td>Modifier : </td> <td><input type="submit" value= "Modifier"/X/tdX/tr> 

</table> 

</fieldset> 
</form> 
</body> 
</html> 
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La mise a jour des coordonnees du client est realisee par le script de l'exemple 15-9. 

La premiere inclusion de code PHP renvoie le client vers la page de saisie du code s'il a 
valide le formulaire sans avoir effectue de saisie (repere ©'■ Rappelons qu'elle doit figu- 
rer en tete du fichier car elle utilise la fonction header( ) pour effectuer la redirection. 

La suite du fichier comporte deux parties distinctes. La premiere cree dynamiquement un 
formulaire permettant la modification des donnees, et la seconde enregistre ces donnees 
dans la base. 

Lors du premier appel du fichier de l'exemple 15-9, la condition de l'instruction if 
(repere©) est necessairement verifiee car la variable $_P0ST['modif '] ne contient rien. 
Elle correspond a la valeur associee au bouton submit du formulaire qui n'est pas encore 
cree. Le script cree une connexion au serveur MySQL pour y lire les coordonnees actuel- 
les du client, dont le code est contenu dans la variable $code issue de la page de saisie de 
l'exemple 15-8 (repere ©). 

La requete SQL selectionne toutes les colonnes de la table cl ient dont l'identifiant client 
(colonne id_client de la table client) correspond a la valeur de la variable $code 
(repere ©) dans le but de completer le formulaire avec les donnees actuelles. Cela 
permet de ne saisir que les modifications eventuelles de coordonnees du client, sans 
devoir ressaisir l'ensemble. Ces coordonnees sont lues a l'aide de la fonction mysql_ 
f etch_row( ) puisque le resultat de la requete SELECT ne comporte qu'une seule ligne. Elles 
sont alors contenues dans la variable $coord de type array. Pour afficher les coordonnees 
dans le formulaire, vous devez attribuer les valeurs de ses elements aux attributs value 
des differents champs <input /> (repere ©). 

La figure 15-7 montre un exemple de creation dynamique de formulaire pour le client 
dont l'identifiant vaut 3. Le champ cache code du formulaire permet de passer la valeur 
du code client a la partie du script chargee de l'enregistrement des donnees modifiees 
(repere Q). 

L'envoi du formulaire utilise la deuxieme partie du script, qui met a jour les donnees du 
visiteur dans la table client apres avoir verifie l'existence de valeurs pour les champs 
obligatoires du formulaire (repere©). Seules les colonnes nom, adresse, ville et mail 
peuvent etre mises a jour a l'aide de la requete suivante (repere Q), le reste etant force - 
ment inchange : 

I UPDATE client SET nom='$nom' ,adresse='$adresse' ,vil le=' $vil le' ,mail = '$mail ' 
WHERE id_client='$code' 

La verification du resultat de la requete (repere ©) permet d' afficher une boite d'alerte 
JavaScript contenant soit un message d'erreur, soit la confirmation de l'enregistrement. 
La page ne devant pas etre une impasse, le visiteur est redirige d'office vers la page 
d'accueil du site index.htm. (reperes © et @). 

Exemple 15-9. Page de modification des coordonnees 

|<?php 
if (empty ($_P0ST[ 'code']) ){ header (" Location: my sqlex8.php" ) ; } <— O 
?> 
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<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtrnlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Modifiez vos coordonnees</title> 
</head> 
<body> 
<?php 

if($_POST['modif ]! = "Enregistrer' ) <— Q 
{ 

//CREATION DU FORMULAIRE 

include( 'connex.inc.php' ) ; 

$code=mysql_escape_string($_POST[ 'code' ]) ; <— © 

//Requete SQL 

$requete="SELECT * FROM client WHERE id_cl ient='$code' " ; <-© 

$idcom=connex( 'magasin' , 'myparam' ) ; 

$resul t=@mysql_query( $ requete, $idcom) ; 

$coord=mysql_fetch_row($ result) ; <— © 

mysql_close($idcom) ; 

//Creation du formul aire <— Q 

echo "<form action= \"". $_SERVER[ ' PHP_SELF' ] . "\" method=\"post 

*»\"enctype=\"appl ication/x-www-form-urlencoded\">" ; 

echo "<fieldset>" ; 

echo "<legend><b>Modifiez vos coordonnees</bX/legend>" ; 

echo "<table>"; 

echo "<tr><td>Nom : </td><td><input type=\"text\" name=\"nom\" 

*size=\"40\" maxlength=\"30\" val ue=\"$coord[l]\"/> </tdX/tr>"; 

echo "<trXtd>Prenom : </tdXtdXinput type=\"text\" name=\"prenom 

*V size=\"40\" maxlength=\"30\" val ue=\"$coord[2]\"/X/tdX/tr>" ; 

echo "<trXtd>Age : </tdXtdXinput type=\"text\" name=\"age\" 

•»size=\"40\" maxlength=\"2\" value=\"$coord[3]\"/X/tdX/tr>" ; 

echo "<trXtd>Adresse : </td><td><input type=\"text\" name=\"adresse\" 

*size=\"40\" maxlength=\"60\" value=\"$coord[4]\"/X/tdX/tr>": 

echo "<trXtd>Ville : </tdXtdXinput type=\"text\" name=\"vil le\" 

•»size=\"40\" maxlength=\"40\" value=\"$coord[5]\"/X/tdX/tr>": 

echo "<trXtd>Mail : </td><td><input type=\"text\" name=\"mail \" 

*size=\"40\" maxlength=\"50\" val ue=\"$coord[6]\"/X/tdX/tr>" ; 

echo "<tr><td><input type=\"reset\" value=\" Effacer \"X/tdXtdXinput 

b »type=\"submit\" name=\"modif\" val ue=\"Enregistrer\"X/tdX/trX/table>" 

echo "</fieldset>" ; 

echo "<input type=\"hidden\" name=\"code\" val ue=\"$code\"/>" ; <— Q 

echo "</form>"; 
} 

elseif(isset($_POST['nom'])M issetd 
*-isset($_POST['ville'])) <-© 
( 



_POST['adresse'])&& 



//ENREGISTREMENT 

include( 'connex.inc.php' ) ; 

$nom=mysql_escape_string($_POST[ 'nom']) ; 

$adresse=mysql_escape_string($_POST['adresse']); 
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le='$ville', s 



$ville=mysql_escape_string($_POST['ville']) ; 

$mail=mysql_escape_string($_POST[ 'mail ' ] ) ; 

$code=mysql_escape_string($_POST[ 'code' ] ) ; 

//Requete SQL 

$requete="UPDATE client SET nom='$nom' ,adresse='$adresse' ,vi" 

*»mail = '$mail ' WHERE id_cl ient='$code'" ; <— Q 

$idcom=connex( 'magasin' , 'my pa ram' ) ; 

$resul t=mysql_query( $ requete, $idcom) ; 

mysql_close($idcom) ; 

if(!$result) <^© 

{ 
echo "<script type=\"text/javascript\"> 
alertt ' Erreur : " .mysql_error( ) . " ' )</script>" ; <— (J) 

} 

el se 

{ 
echo "<script type=\"text/javascript\"> alert('Vos modifications 
*»sont enregistrees' ) ;window.location=' index.htm' ;</script>" ; <— © 



) 
else 



echo "Modifier vos coordonnees!' 



?> 

</body> 

</html> 
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Verification 

Pour verifier que la mise a jour a bien ete realisee, vous pourriez appeler la fonction mysql_af f ected_ 
rows ( ) , dont la syntaxe est int mysql_af f ected_rows ( [$i dcom] ) . Elle retourne le nombre de lignes 
concernees par les commandes SQL INSERT, UPDATE et DELETE. Lors de la mise a jour des coordon- 
nees d'un client, elle retourne la valeur 1 si I'operation est menee a bien. Au repere © de I'exemple 15-9, 
vous pourriez done ecrire : 

if (mysql_affected_rows( ) !=1) 
{//Affichage de l'erreur 

} 

else 

{//Message de confirmation 



Recherche dans la base 

Un site de commerce en ligne doit permettre a ses visiteurs et futurs clients d'effectuer 
des recherches dans la base de donnees afin d'acceder plus rapidement a l'information 
sur le produit recherche. II doit en outre permettre d'effectuer des statistiques marketing 
a 1' usage du proprietaire du site. Ces recherches concernent aussi bien les sites de 
commerce en ligne que les annuaires et moteurs de recherche des sites de contenu. 

L'exemple 15-10 cree un formulaire classique permettant de saisir un mot-cle et d'effec- 
tuer des choix de tri des resultats. Les criteres de tri selon le prix, la categorie ou l'identi- 
fiant d' article sont affiches sous forme de liste deroulante ainsi que celui du critere de tri 
selon le prix, la categorie ou l'identifiant d'article. Le choix de l'ordre croissant ou 
decroissant s'effectue au moyen de deux boutons radio ayant le meme attribut name, ce 
qui les rend exclusifs l'un de 1' autre. 

Le script controle d'abord que le visiteur a saisi un mot-cle dans le formulaire en veri- 
fiant que la variable $_P0ST[ 'motel e'] n'est pas vide (repere Q). II recupere ensuite le 
mot-cle, la categorie, le critere de tri et l'ordre d' affichage respectivement dans les varia- 
bles $motcle, $categorie, $ordre et $tri (reperes Q a ©). 

Si la categorie choisie est "tous", la partie de la commande WHERE concernant cette catego- 
rie est vide. Pour les autres choix, elle est egale a "AND categori e=$categori e" (repere ©). 
La requete de selection suivante (repere Q) est alors creee par le code : 

"SELECT id_article AS 'Code article' .designation AS 'Description' .prix, categorie AS 

'Categorie' 

FROM article 

WHERE lower(designation) LIKE'%$motcle%'" .Sreqcategorie. " 

ORDER BY $tri $ordre" 

On peut remarquer l'utilisation de la fonction MySQL 1 ower( ) qui permet d'effectuer une 
recherche sans tenir compte de la casse ; de cette facon, que l'utilisateur cherche les 
mots-cles sony ou Sony il obtiendra bien les resultats presents dans la table arti cl e. 
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L'utilisation d' alias donne un meilleur affichage des titres du tableau de resultats. Apres 
la connexion au serveur, vous recuperez le resultat de la requete dans la variable $resul t. 
La lecture des resultats et l'affichage de toutes les lignes retournees sont realises par le 
meme code que celui de l'exemple 15-5 (repere ©). La figure 15-8 illustre la page creee 
apres la recherche du mot-cle portabl e. 

Exemple 15-10. Page de recherche d'articles 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<title>Rechercher un article dans le magasin</title> 
</head> 
<body> 

<form action= "<?php echo $_SERVER[ ' PHP_SELF' ]?>" method="post" 

*»enctype="appl ication/x-www-form-url encoded "> 

<fieldset> 

<legend><b>Rechercher un article en magasin</b></legend> 

<table> 

<tr> <td>Mot-cle: </td> 

<td><input type="text" name="motcle" size="40" maxlength="40" 

*»value="<?php $_P0ST[ 'motel e']?>"/X/td> 

</tr> 

<tr> 

<td>Dans la categorie : </td> 

<td> 

<select name="categorie"> 

<option value="tous">Tous</option> 

<option value="video">Video</option> 

<option value=" informatique">Informatique</option> 

<option val ue= " photo ">Photo</option> 

<option value="divers">Divers</option> 

</select> 

</td> 

</tr> 

<tr> 

<td>Trier par : </td> 

<td> 

<select name="tri"> 

<option value="prix">Prix</option> 

<option value="categorie">Categorie</option> 

<option value="id_article">Code</option> 

</select> 

</td> 

</tr> 

<trXtd>En ordre: </td> 
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<td>Croissant<input type="radio" name="ordre" value="ASC" checked="checked"/> 

*»Decroissant<input type="radio" name="ordre" value="DESC" /> 

</td> </tr> 

<tr><td>Envoyer</tdXtd><input type="submit" name="" value="OK"/> </td> </tr> 

</table> 

</fieldset> 

</form> 
<?php 

if(!empty($_POST['motcle'])) <-© 
{ 

include( 'connex.inc.php' ) ; 

$motcle=mysql_escape_string($_POST[ ' motel e' ]) ; <— © 

$categorie=mysql_escape_string($_POST[ 'categorie' ] ) ; <— © 

$ordre=mysql_escape_string($_POST[ 'ordre' ] ) ; <— © 

$tri=mysql_escape_string($_POST['tri ']); <— © 

//Requete SQL 

$reqcategorie=($_POST[ 'categorie' ]=="tous" )?"" : "AND categories 
*» 'Scategorie' " ; <— © 

$requete="SELECT id_article AS 'Code article' .designation AS 'Description' ,prix, 
^categorie AS 'Categorie' FROM article WHERE lower(designation) LI KE ' % 
*$motcler ".Sreqcategorie. "ORDER BY $tri $ordre";<— © 
$idcom=connex( 'magasin' , 'my pa ram' ) ; 
$resul t=mysql_query( $ requete, $idcom) ; <— © 
if(!$result) <-© 
{ 
echo "Lecture impossible"; 



else 
{ 



$nbcol =mysql_num_fi el ds($ result) ; 

$nbart=mysql_num_rows($result) ; 

echo "<h3> II y a $nbart articles correspondant au mot-cle 

//Affichage des titres du tableau 

echo "<table border=\"l\"> <tr>"; 

for($i=0;$i<$nbcol ;$i++) 



$motcle</h3>"; 



echo "<th>", mysql_field_name($result,$i ) ," </th>" 
} 

echo "</tr>"; 

//Affichage des valeurs du tableau 
for($i=0;$i<$nbart;$i++) 
{ 

$1 igne=mysql_fetch_row($result) ; 

echo "<tr>"; 

for($j=0;$j<$nbcol ;$j++) 



echo "<td>",$ligne[$j],"</td>"; 
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echo "</tr>"; 
} 

echo "</table>"; 
mysql_f ree_resul t($resul t) ; 



} 
} 

?> 

</body> 
</html> 
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Figure 15-8 

Formulaire de recherche et resultats obtenus 



Ce chapitre a montre les differentes techniques qui permettent de lire les donnees d'une 
base et d'en enrichir le contenu a partir de saisies effectuees dans un formulaire. 

La selection d' informations en reponse a la requete d'un visiteur et l'affichage des resul- 
tats dans une page creee dynamiquement a partir de ces resultats sont les elements 
preponderants de la creation de sites dynamiques. Les etudes de cas du chapitre 21 illus- 
trent davantage ces techniques. 
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Memo des fonctions 



int mysql_affected_rows( [resource $idcom]) 

Retourne le nombre de lignes concernees par la derniere requete SQL INSERT, DELETE ou UPDATE envoyee au serveur. 

string mysql_cl ient_encoding( [resource $idcom]) 

Retourne le nom du jeu de caracteres utilise par le client MySQL pour la connexion en cours si elle n'est pas precisee. 

boolean mysql_close( [resource $idcom]) 

Ferme la connexion MySQL dont I'identifiant est precise ou la connexion en cours. Retourne TRUE si [operation a lieu et 
FALSE dans le cas contraire. 

resource mysql_connect(string $host, string $user, string $pass) 

Ouvre une connexion a un serveur MySQL identifie par $host pour le client $user et le mot de passe $pass. Retourne 
un identifiant de connexion. 

boolean mysql_data_seek( resource $result,int numero_l igne) 

Place le pointeur dans le resultat $result a la ligne indiquee et retourne TRUE si [operation est reussie. L'appel de la 
fonction mysql_fetch_row( ) retourne cette ligne. 

string mysql_db_name( resource $result,int N) 

Retourne le nom de la nieme base figurant dans le resultat $result retourne par la fonction mysql_list_dbs(). 

int mysql_errno( [resource $idcom]) 

Retourne le numero de la derniere erreur survenue pour la connexion precisee ou celle qui est en cours si le parametre 
est omis. 

string mysql_error([resource $idcom]) 

Retourne le dernier message d'erreur pour la connexion precisee ou celle qui est en cours si le parametre est omis. 

string mysql_escape_string(string $ch) 

Protege les caracteres speciaux de la chaine $ch (sauf % et _) et retourne la chaine protegee. 

array mysql_fetch_array( resource $result[,int typetab]) 

Retourne la ligne en cours du resultat dans un tableau. Chaque appel de la fonction retourne la ligne suivante ou FALSE 
s'il n'y a plus de ligne. Le parametre typetab precise le type du tableau retourne : associatif avec la valeur MYSQL_ASSOC, 
indice avec la valeur MYSQL_NUM, les deux avec MYSQL_BOTH (utilise plus de memoire). 

array mysql_fetch_assoc( resource $result) 

Identique a la fonction mysql_fetch_array( ) utilisee avec le parametre MYSQL_ASSOC. 

object mysql_fetch_field(resource Sresult [.int numero_colonne]) 

Retourne un objet dont les proprietes contiennent des informations sur les donnees du resultat. Ces proprietes sont les 

suivantes : 

name : nom de lacolonne. 

table: nom de la table contenant la colonne. 

max_l ength : taille de la colonne de type VARCHAR. 

not_nul 1 : vaut 1 si la colonne a cette option. 

primary_key : vaut 1 si la colonne est une cle primaire. 

um'que_key : vaut 1 si la colonne a [option UNIQUE. 
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multi pi e_key : vaut 1 si la colonne est une cle non unique. 

numeric : vaut 1 si la colonne est de type numerique. 

bl ob : vaut 1 si la colonne est de type BLOB. 

type : type de la colonne. 

unsigned : vaut 1 si la colonne a I'option UNSIGNED. 

zerof i 1 1 : vaut 1 si la colonne a I'option ZEROFI LL (pour les types numeriques). 

array mysql_fetch_lengths( resource Sresult) 

Retourne la taille de chaque colonne du resultat. 

object tnysql_fetch_object( resource $result) 

Retourne une ligne du resultat dans un objet dont les proprietes ont pour nom celui des colonnes et qui contiennent les 
valeurs de chaque colonne. 

array mysql_fetch_row( resource Sresult) 

Retourne un tableau indice contenant la ligne en cours du resultat precise et FALSE s'il n'y a plus de ligne. 

string mysql_fi el d_f1ags( resource $result, int numero_colonne) 

Retourne les options de la colonne precisee du resultat. Les valeurs possibles sont : 'not_null ' , 'primary_key' . 
' unique_key ' , 'mul tiple_key' , 'blob', 'unsigned', ' zerofill', 'binary', 'enum', 'auto_increment' 
et ' times tamp'. Voir aussi lafonction mysql_fetch_field(). 

int mysql_fi el d_l en (resource $result, int N) 

Retourne la taille de la colonne N du resultat. 

string mysql_field_name(resource $result, int N) 

Retourne le nom de la nieme colonne du resultat. 

int mysql_field_seek(resource $result, int numero_colonne) 

Place le pointeurde resultat sur la nieme colonne du resultat. L'appel de lafonction mysql_fetch_field( ) retourne la 
valeur du champ. 

string tnysql_field_table(resource $result,int N) 

Retourne le nom de la table qui contient la nieme colonne du resultat. 

string mysql_field_type( (resource $result, int N) 

Retourne le type de la nieme colonne du resultat. 

boolean mysql_f ree_result(resource $result) 

Libere la memoire utilisee par le resultat et retourne TRUE en cas de reussite et FALSE dans le cas contraire. 

int mysql_insert_id(resource $idcom) 

Retourne la derniere valeur entiere inseree dans une colonne ayant I'option AUTO_INCREMENT. 

resource mysql_l ist_dbs(resource $idcom) 

Retourne un identifiant de resultat contenant la liste des bases de donnees du serveur MySQL. 

resource mysql_l ist_fi elds (string base, string tablet, resource $idcom]) 

Retourne un identifiant de resultat contenant la liste des colonnes d'une table donnee situee dans une base precisee. 

rsource mysql_l ist_tables(string base[, resource $idcom]) 

Retourne un identifiant de resultat contenant la liste des tables d'une base. 
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int mysql_num_fi elds (resource $result) 

Retourne le nombre de colonnes presentes dans un resultat. 

int tnysql_num_rows( resource $result) 

Retourne le nombre de lignes d'un resultat. 

resource mysql_pconnect(string $host, string $user, string $pass) 

Identique a lafonction mysql_connect( ) mais cree une connexion permanente. 

boolean mysql_ping([resource $idcom]) 

Verifie si la connexion est toujours active et effectue une reconnexion dans le cas contraire. Retourne TRU E si la connexion 
est effectuee et FALSE dans le cas contraire. 

resource mysql_query(string $requete[ .resource $idcom[,int mode]]) 

Envoie une requete SQL au serveur et retourne un identifiant de resultat. 

string mysql_real_escape_string(string $chaine [, resource $idcom]) 

Echappe la chaine precisee afin de I'inclure dans une requete SQL. 

divers mysql_resul t( resource $result,int N [.divers M]) 

Retourne la valeur du champ de la colonne M de la ligne N du resultat. 

boolean mysql_select_db(string base[, resource $idcom]) 

Choisit la base sur laquelle vont s'effectuer les operations suivantes. Retourne TRUE si la base existe et FALSE dans le cas 
contraire. 

string mysql_tablename( resource $result,int N) 

Utilise I'identifiant de resultat retourne par la fonction mysql_list_tables() et retourne le nom de la nieme table de la 
base. 

resource mysql_unbuffered_query(string $requete[, resource $idcom]) 

Envoie une requete au serveur mais ne met pas le resultat en buffer. Le resultat doit etre utilise avant renvoi d'une autre 
requete. 



Exercices 



Tous les exercices ci-dessous portent sur la base de donnees voitures creee au chapi- 
tres 13 et 14. 

Exercice 1 

Creez un script permettant d'afficher le contenu de la table model e dans un tableau 
XHTML. Les resultats doivent etre tries par marque. 

Exercice 2 

Creez un formulaire permettant l'insertion de nouvelles donnees dans la table model e. 
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Exercice 3 

Creez un formulaire permettant l'insertion simultanee des coordonnees d'une personne 
dans les tables proprietaire et cartegrise. II doit contenir les zones de saisie des coor- 
donnees de la personne et la liste des modeles d'une marque creee dynamiquement a 
partir de la saisie de la marque. 

Exercice 4 

Creez un formulaire de recherche permettant de retrouver tous les proprietaries d'un type 
de vehicule de marque et de modele donnes. Affichez les resultats sous forme de tableau 
XHTML. 

Exercice 5 

Creez un formulaire de recherche permettant de retrouver tous les vehicules possedes par 
une personne donnee. Affichez les resultats sous forme de tableau XHTML. 

Exercice 6 

Reecrivez entierement le code de l'exercice 5 en recuperant tous les resultats dans des 
objets et en manipulant leurs proprietes. 
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Acces objet a MySQL 

avec PHP 



Une tendance evidente qui a prevalu dans le developpement de PHP 5 est la programma- 
tion objet ; l'acces a MySQL n'y a pas echappe, et cela n'a fait que s'accentuer dans les 
versions successives de PHP 5. Cette possibilite est liee a l'utilisation de l'extension 
mysql i, dite « mysql amelioree », qui comprend les trois classes suivantes : 

• La classe mysql i qui permet de creer des objets de type mysql i_object. Cette derniere 
possede pas moins de 33 methodes et 15 proprietes pouvant remplacer ou completer 
les fonctions de l'extension mysql comme la connexion a la base, l'envoi de requetes, 
les transactions ou les requetes preparees. 

• La classe mysql i_resul t, permettant de gerer les resultats d'une requete SQL effectuee 
par l'objet precedent. Ses methodes et proprietes sont egalement les equivalents des 
fonctions de l'extension mysql vues au chapitre 15. 

• La classe mysql_stmt qui represente une requete preparee. II s'agit la d'une nouveaute 
par rapport a l'extension mysql . 

Nous allons maintenant reprendre des differents exemples du chapitre 15 et voir comment 
obtenir les memes resultats via un acces objet. Ce chapitre peut done etre aborde inde- 
pendamment du chapitre precedent. 

Connexion au serveur MySQL 

Comme il se doit, la premiere chose a faire est de se connecter au serveur MySQL. Pour 
cela nous creons un objet de la classe mysql i selon la syntaxe suivante : 
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$idcom = new mysqli (string $host, string $user, string $pass [.string $base]) ; 

$idcomest unobjet mysqli et $host, $user et $pass sont, comme dans le chapitre 15, le nom 
du serveur MySQL, le nom de l'utilisateur et le mot de passe. Le parametre facultatif 
$base permet de choisir d'emblee la base sur laquelle seront effectuees les commandes 
SQL. 

Nous pouvons egalement reutiliser le fichier myparam.inc.php, cree au chapitre 15, 
contentant les parametres de connexions (ci-dessous en local) : 

Exemple 16-1. Le fichier myparam.inc.php 

<?ph P 

define("MYHOST","localhost") : 

define("MYUSER"."root"); 

defineC'MYPASS".""); 

?> 

L'objet $idcom representant la connexion sera utilise directement ou indirectement pour 
toutes les operations a effectuer sur la base. Si la connexion n'est pas effectuee, la varia- 
ble $idcom contiendra la valeur FALSE, permettant ainsi de tester si la connexion est bien 
realisee. 

La connexion prend fin quand l'execution du script PHP est terminee, mais on peut y 
mettre fin explicitement pour observer le serveur MySQL. Si les resultats d'une requete 
sont entierement recuperes, la connexion peut en effet etre coupee avec la methode 
closet ) selon la syntaxe suivante : 

boolean $idcom->close( ) 

Si le serveur comporte plusieurs bases de donnees et que le parametre $base a ete 
employe lors de la creation de l'objet $i dcom, il est possible de changer de base sans inter- 
rompre la connexion en cours en appelant la methode select_db() avec la syntaxe 
suivante : 

boolean $idcom->select_db (string Sbase) 

Cette methode retourne un booleen qui permet de tester la bonne fin de 1' operation. Si le 
parametre Sbase n'a pas ete precise lors de la creation de l'objet mysqli, c'est cette 
methode qui permet de choisir la base. 



Selection de la base via SQL 

Comme nous I'avons vu au chapitre 15, vous pouvez aussi selectionner une base en envoyant la requete 
"USE nom_base" au serveur a I'aide de la methode query ( ) detaillee dans les sections suivantes. 



En cours de script, vous pouvez a tout moment tester si la connexion est encore active en 
appelant la methode pingO selon la syntaxe suivante : 



boolean $idcom->ping( ) 
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Celle-ci renvoie TRUE si la connexion est active, sinon elle renvoie FALSE et effectue une 
reconnexion avec les parametres initiaux. 

La structure d'un script accedant a MySQL est done la suivante : 

<?php 

//Inclusion des parametres de connexion 

incl ude_onceCmyparam.inc.php") ; 

//Connexion au serveur 

$idcom = new mysqli (MYHOST.MYUSER.MYPASS, "ma_base" ) ; 

//Affichage d'un message en cas d'erreurs 

if( !$idcom) 

{ 

echo "<script type=text/javascript>" ; 

echo "alert( 'Connexion Impossible a la base)</script>" ; 

} 
//it******************************* 

//Requetes SQL sur la base choisie 
//Lecture des resultats 
//******************************** 

//Fermeture de la connexion 

$idcom->close( ) ; 

?> 

Comme nous l'avons fait pour l'acces procedural a MySQL, nous avons interet a creer 
une fonction de connexion au serveur que nous reutiliserons systematiquement dans 
tous les exemples qui suivent. C'est l'objet de l'exemple 16-2 qui cree la fonction 
connexobjet( ) dont les parametres sont le nom de la base dans la variable $base et le nom 
du fichier .inc. php contenant les parametres de connexion dans la variable $param. 

La fonction inclut d'abord les parametres de connexion (repere Q) puis cree un objet 
mysql i (repere ©) ; elle verifie ensuite que la connexion est bien realisee (repere ©), affi- 
che un message d'alerte JavaScript et sort de la fonction en cas de probleme (repere ©). Si 
la connexion est bien realisee elle retourne l'objet $idcom (repere 0). 

Exemple 16-2. Fonction de connexion au serveur 

<?php 

function connexobjet($base,$param) 

{ 

incl ude_once($param. " .inc. php" ) ; <— © 

$idcom = new mysql i (MYHOST,MYUSER,MYPASS,$base) ; <-© 

if (!$idcom) <-© 

{ 

echo "<script type=text/javascript>" ; 
echo "alert( 'Connexion Impossible a la base' )</script>" ; 
exitO; <-© 
} 

return $idcom; <— © 
} 
?> 
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Chacun de vos scripts d'acces a la base doit done contenir les lignes suivantes : 

incl udeC'connexobjet.inc.php" ) ; 



L'operation de connexion est done geree en deux lignes. 



Envoi de requetes SQL au serveur 

Les differentes operations a realiser sur la base MySQL impliquent 1' envoi de requetes 
SQL au serveur. 

Pour envoyer une requete, il faut employer la methode query( ) de l'objet mysql i dont la 
syntaxe est : 

clivers $idcom->query (string $requete [,int mode ]) 

La requete est soit directement une chaine de caracteres, soit une variable de meme type. 
Le parametre mode est une constante qui prend la valeur MYSQLI_USE_RESULT ou MYSQLI_ 
STORE_RESULT, cette derniere etant la valeur par defaut. Avec MYSQLI„STORE_RESULT, il est 
possible d'envoyer plusieurs requetes sans liberer la memoire associee a un premier 
resultat, tandis qu'avec 1' autre methode, il faut d'abord liberer cette memoire a l'aide de 
la methode free_result( ) appliquee a l'objet Sresult (de type mysql i_result). 

La methode queryt ) retourne TRUE en cas de reussite et FALSE sinon et un objet de type 
mysql i_resul t pour les commandes SQL de selection comme SELECT. Nous pouvons done 
tester la bonne execution d'une requete. En resume, un script d'envoi de requete a la 
forme suivante : 

*~ Exemple 16-3 Envoi de requete type 

<?php 

incl ude_once( "connexobjet .inc.php" ) ; <— O 

$idcom=connexobjet("magasin" , "my pa ram" ) ; <— © 

$requete="SELECT * FROM article ORDER BY categorie" ; <— © 

$result=$idcom->query($requete) ; <— O 

if(!$result) 

{ 

echo "Lecture impossible" ; <— © 
} 

else 
{ 
//Lecture des resultats<— Q 
while ($row = $resul t->fetch_array(MYSQLI_NUM) ) 
{ 

foreach($row as $donn) 
{ 

echo $donn, " " ; 
} 
echo "<hr />"; 
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} 

//Destruction de 1 'objet $result 

Sresult->close( ) ; 
} 

// Fermeture de la connexion 
$idcom->close( ); <— © 
?> 

Ce script effectue successivement l'inclusion du fichier connexobjet.inc.php (repere Qi. la 
connexion au serveur (repere ©), l'ecriture de la requete SQL dans la variable $requete 
(repere ©), l'envoi de la requete et la recuperation du resultat (repere ©) puis l'affichage 
d'un message d'erreur eventuel (repere 0) ou bien des resultats, procedure que nous 
detaillerons dans le paragraphe suivant (repere ©) et, enfin, la liberation de la memoire 
occupee par l'objet mysql i„resul t (repere ©). 



Lecture du resultat d'une requete 

Pour les operations d' insertion, de suppression ou de mise a jour de donnees dans une 
base, il est simplement utile de verifier si la requete a bien ete executee. 

Par contre, lorsqu'il s'agit de lire le resultat d'une requete contenant la commande SELECT, la 
methode query ( ) retourne un objet de type mysql i_resul t, identifie dans nos exemples par 
la variable Sresul t. La classe mysql i_resul t offre une grande variete de methodes permet- 
tant de recuperer des donnees sous des formes diverses, la plus courante etant un tableau. 
Chacune de ces methodes ne recuperant qu'une ligne du tableau a la fois, il faut recourir 
a une ou plusieurs boucles pour lire l'ensemble des donnees. 

Lecture a I'aide d'un tableau 

La methode des objets instances de la classe mysql i_resul t la plus perfectionnee pour lire 
des donnees dans un tableau est fetch_array( ), dont la syntaxe est : 

array Sresul t->fetch_array (int type) 

Elle retourne un tableau qui peut etre indice (si la constante type vaut MYSQLI_NUM), asso- 
ciatif (si type vaut MYSQLI_ASSOC), dont les cles sont les noms des colonnes ou les alias de 
la table interrogee, ou encore mixte, contenant a la fois les indices et les cles (si type vaut 
MYSQLI_BOTH). Pour lire toutes les lignes du resultat, il faut ecrire une boucle (while par 
exemple) qui effectue un nouvel appel de la methode fetch_array() pour chaque ligne. 
Cette boucle teste s'il existe encore des lignes a lire, la methode fetch_array( ) retournant 
la valeur NULL quand il n'y en a plus. Pour lire et afficher chaque ligne nous utilisons 
ensuite une boucle foreach. Notez encore une fois que si le tableau retourne est indice, 
l'indice correspond au premier attribut ecrit dans la requete et ainsi de suite. 

Les methodes suivantes permettent egalement de recuperer une ligne de resultat a la fois : 

array Sresul t->fetch_assoc(void) 
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retourne un tableau associatif dont les cles sont les noms des colonnes de la table. 

array $resul t->fetch_row(void) 

done les indices de a N sont les positions des attributs dans la requete SQL. 

L'exemple 16-4 met cette methode en pratique dans le but d'afficher le contenu de 
la table arti cl e de la base magasi n dans un tableau XHTML. Apres l'inclusion de la fonc- 
tion de connexion (repere ©) puis son appel sur la base magasi n (repere ©) nous ecrivons 
la requete SQL de selection (repere ©). L'envoi de la requete avec la methode query( ) 
permet de recuperer un objet $result ou FALSE en cas d'echec (repere ©). Un test sur 
la variable $result (repere ©) permet d'afficher un message d'erreur (repere ©) ou le 
contenu de la table (repere ©). Nous recuperons d'abord le nombre d' articles dans la 
table grace a la propriete num_rows de l'objet mysqli_result (repere©) et affichons ce 
nombre dans un titre <h4> (repere ©). Une boucle whi 1 e permet de lire une ligne a la fois 
dans un tableau indice (repere ©), puis une boucle foreach permet d'afficher chacune 
des valeurs du tableau dans un tableau XHTML (repere©). L'objet $result est alors 
supprime (repere ©) et la connexion fermee (repere ©). La figure 16-1 montre l'affi- 
chage obtenu dans un navigateur. 

Exemple 16-4. Lecture de la table article 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=utf-8" /> 

<title>Lecture de la table article</title> 

<style type="text/css" > 

table {border-style:double;border-width: 3px;border-color: red; 

*»background-color: yellow;} 

</style> 
</head> 
<body> 
<?php 

incl udeC'connexobjet.inc.php" ) ; <— © 
$idcom=connexobjet( "magasi n" , "my pa ram" ) ; <— © 
$requete="SELECT * FROM article ORDER BY categorie" ; <— © 
$result=$idcom->query($requete) ; <— © 
if(!$result) <-© 
{ 

echo "Lecture impossible" ; <—© 
} 

else <— © 
{ 

$nbcol =$resul t->f i el d_count ; 

$nbart=$resul t->num_rows; <— © 

echo "<h3> Tous nos articles par catégorie</h3>" ; 

echo "<h4> II y a $nbart articles en magasin </h4>";<— © 
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echo "<table border=\"l\">" ; 

echo "<tr><th>Code article</th> <th>Description</th> <th>Prix</th> 
w-<th>Catégorie</thX/tr>" ; 
while($ligne=$result->fetch_array(MYSQLI_NUM)) <-© 
{ 
echo "<tr>"; 

foreach($ligne as Svaleur) <— (J) 
{ 

echo "<td> Svaleur </td>"; 
} 

echo "</tr>"; 
} 

echo "</table>"; 
} 

$result->close(); <— © 
$idcom->close(); <^© 
?> 

</body> 
</html> 
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Tous nos articles par categorie 

II v a 11 articles en mag a sin 



Code ankle Description 


Pris Categorie 


|ca.30o 


[Canon FOS 3000V ™nm 2R/80 


329.00 |photo 


NIK80 


[Nikon F80 


479.00 jphoto 


NIK55 


|Nikon F5 5 I zoom 28/80 


269.00 |plioto 


CP100 


[Camescope Panasonic SV-AV 100 


1490.00 1 video 


JCS330 


Camescope Sony DCR-PC330 


1629.00 |video 


SAX15 


jPorlable Samsung XI 5 X\\M 


1999.00 linfui-maliquc 


JHP497 


PC Bureau HP497 ecran TFT 


1 500.00 iriformatique ; 


JSOXMP 


PC Portable Sony Zl-XMP 


2399.00 |iniormatique | 


DEL30 


Portable Dell X3 00 


1715.00 |informatique ; 


|CAS07 


Cassette DV60 par 5 


26.90 divers 


DVD75 


|DVD vierge par 3 


17.50 |divers 



Figure 16-1 

Lecture de la table article 
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Lecture des noms de colonnes. 

Dans l'exemple precedent, les titres des colonnes du tableau XHTML etant ecrits a 
l'avance dans le script, nous pouvons automatiser cette operation en recuperant les noms 
des colonnes de la table interrogee ou les alias figurant dans les requete SQL. La 
methode fetch_fields() d'un objet mysql i_resul t nous fournit ces informations et bien 
d'autres concernant la table. Sa syntaxe est : 

array $result->fetch_fi elds (void) 

Le tableau retourne contient autant d'objets qu'il existe de colonnes dans la requete SQL. 
Ces derniers ont tous les memes proprietes, detaillees dans le tableau 16-1, permettant 
d'obtenir des informations sur les attributs de la table. 

Tableau 16-1 Definition des proprietes 



Propriete 


Definition 


name 


Nom de la colonne 


orgname 


Nom initial de la colonne si un alias a ete cree 


table 


Nom de la table a laquelle la colonne appartient (s'il n'a pas ete obtenu dynamiquement par conca- 
tenation par exemple) 


orgtable 


Nom initial de la table si un alias a ete cree 


def 


Valeur par defaut de I'attribut, donnee dans une chaine de caracteres 


tnax_length 


Longueur maximale du champ pour le jeu de resultats 


length 


Longueur du champ dans la definition de table 


charsetnr 


Jeu de caracteres pour cet attribut 


flags 


Entier representant le bit-flags pour cet attribut 


type 


Type de donnees utilisees pour I'attribut 


decimal s 


Nombre de decimales utilisees (pour les attributs de type entier) 



Ces informations peuvent nous permettre de reconstituer la structure de la table a laquelle 
nous avons acces sans en connaitre les details. 

Nous allons utiliser une de ces proprietes pour creer automatiquement les en-tetes d'un 
tableau XHTML a partir des noms des colonnes ou des alias eventuels definis dans la 
requete. L'exemple 16-5 illustre cette possibilite a partir d'une requete SQL selection- 
nant les articles de la table arti cl e dont la designation contient le mot « Sony » en defi- 
nissant des alias pour les noms des colonnes (repere O k Apres l'envoi de la requete par 
la methode queryO, nous recuperons le resultat (repere ©) puis son nombre de lignes 
(repere ©) et le tableau d'objets Ititres contenant les informations presentees dans le 
tableau 16-1 (repere ©). Les noms des colonnes ou des alias employes ici sont contenus 
dans les proprietes $titres->name et lus un par un a l'aide d'une boucle foreach 
(repere ©), puis affiches dans les en-tetes par des elements <th> du tableau XHTML 
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(repere ©). L'affichage des donnees selectionnees est realise dans une boucle whi 1 e avec 
la methode f etch_array( ) comme dans l'exemple precedent. Le tableau retourne etant ici 
indice (repere ©), sa lecture est effectuee par une boucle foreach. Le resultat et l'objet 
connexion sont ensuite supprimes. 

Exemple 16-5. Lecture des noms des colonnes 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 

<title>Lecture de la table article</title> 

<style type="text/css" > 

table {border-style:double;border-width: 3px;border-color:red; 

*»background-color: yellow;} 

</style> 
</head> 
<body> 
<?php 

incl udeC'connexobjet.inc.php") ; 
$idcom=connexobjet("magasin" , "my pa ram" ) ; 
// 

$requete="SELECT id_article AS 'Code article' .designation AS 'Designation' ,prix 
*»AS 'Prix Unitaire' .categorie AS 'Categorie' FROM article WHERE designation 
••LIKE 'SSSonyr ORDER BY categorie" ; <-© 
// 

$result=$idcom->query($requete) ; <— © 
// 

if(!$result) 
{ 

echo "Lecture impossible"; 
} 



$nbart=$resul t->num_rows ; <— © 

$titres=$result->fetch_fields(); <-© 

echo "<h3> Tous nos articles de la marque Sony</h3>"; 

echo "<h4> II y a $nbart articles en magasin </h4>"; 

echo "<table border=\"l\"> <tr>"; 

//Affichage des titres 

foreach($titres as $colonne)<— © 

{ 

echo "<th>", htmlentities($colonne->name) ,"</th>";<— © 
} 

echo "</tr>"; 

//Lecture des lignes de resultat 
while($ligne=$result->fetch_array(MYSQLI_NUM)) <-© 
{ 
echo "<tr>"; 
foreach($ligne as $valeur) 
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echo "<td> Svaleur </td>"; 
} 

echo "</tr>"; 
} 

echo "</table>"; 
} 

$resul t->f ree_resul t( ) ; 
$idcom->close( ) ; 
?> 

</body> 
</html> 

La figure 16-2 illustre les resultats obtenus. 
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Tous nos articles de la marque Sony 

Ih a 2 articles eu niagasin 



(Code article 


| Designation 


|Pris I nitair* 


'| Categoric 


JCS33Q 


[Camescope Sony DCR-PC330 1629.00 


[video 


jsOXMP 


|PC Portable Sony Zl-XMP 


2399.00 


jmformatique 



Figure 16-2 

Lecture des noms des colonnes 



Recuperation des valeurs dans un objet 

Les objets de type mysqli_result possedent la methode fetch_object() dont la syntaxe 
est : 

object $result->fetch_object( ) 

A chaque appel de cette methode, 1' objet retourne represente une ligne de resultat et 
possede autantdeproprietesqu'il existed 'attributs dans la requete SQL SELECT ; les noms 
de ces proprietes sont ceux des colonnes de la table ou des alias eventuels. 

Si nous recuperons une ligne de resultat dans la variable $1 igne : 

$1 igne=$result->fetch_object( ) 

La valeur d'un attribut nom est lue avec la ligne de code : 

$1 igne->nom 



Acces objet a MySQL avec PHP 

Chapitre 16 

L'exemple 16-6 realise, en employant cette methode, la recherche et l'affichage dans un 
tableau XHTML de tous les clients qui habitent Paris. Par contre, pour afficher les titres 
du tableau nous n'allons pas utiliser la methode fetch_fields() comme precedemment. 
Dans la requete SQL nous definissons des alias qui vont etre les en-tetes (repere Q). 
Pour les lire, nous appelons une premiere fois la methode fetch_object() pour l'objet 
$result (repere ©) et recuperons un objet $titres. Ici, ce ne sont pas les valeurs de ses 
proprietes qui nous interessent mais leurs noms. Ces derniers sont recuperables dans la 
variable Icolonne en appliquant une boucle foreach a l'objet $titres (repere©). Nous 
integrons alors ces valeurs dans des elements <th> (repere ©). Nous pourrions mainte- 
nant appeler de nouveau la methode fetch_object() pour lire les donnees mais, ace niveau, 
il se pose un probleme. En effet, cette methode ayant deja ete appelee, un deuxieme appel 
lirait la deuxieme ligne de resultat et la premiere serait perdue. Une solution est d'utiliser 
la methode data_seek( ) (repere ©), dont la syntaxe est : 

boolean $result->data_seek(int N) 

Le parametre N designe la ligne de resultat sur laquelle nous voulons pointer. Le booleen 
retourne permet de verifier que 1' operation est bien realisee et que la ligne N existe bien, 
par exemple. Nous pouvons maintenant utiliser une boucle while pour lire chacune des 
lignes du resultat (repere ©) et afficher les donnees. Remarquez que, comme nous 
l'avons deja signale, les noms des proprietes de l'objet $ligne sont ici les alias definis 
dans la requete SQL (repere Qi). Le tableau XHTML obtenu est represente a la figure 16-3. 

Exemple 16-6. Lecture des donnees dans un objet 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 
<title>Lecture de la table cl ient</title> 
<style type="text/css" > 

table {border-style :double;border-width:3px; border-col or: red; 
^►background-col or: yellow; } 
</style> 
</head> 
<body> 
<?php 

incl udeC'connexobjet.inc.php") ; 
$idcom=connexobjet("magasin" , "myparam" ) ; 

$requete="SELECT id_client AS 'Code_client' ,nom,prenom,adresse, age, mail 
*FR0M client WHERE ville ='Paris' ORDER BY nom";<-© 
$ res ult=$idcom->query($ requete) ; 
if(!$result) 
{ 

echo "Lecture impossible"; 
} 
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else 
{ 
$nbart=$resul t->num_rows ; 

echo "<h3> II y a $nbart clients habitant Pari s</h3>" ; 
//Affichage des titres du tableau 
$titres=$result->fetch_object( ) ; <— © 
echo "<table border=\"l\"> <tr>"; 
foreach($titres as $colonne=>$val ) <— © 
{ 

echo "<th>", $colonne , "</th>";<^© 
} 
echo "</tr>"; 

//Affichage des valeurs du tableau 
echo "<tr>"; 

$result->data_seek(0); <— © 
while ($1 i gne - $result->fetch_object( ) ) <— © 
{ 
echo"<td>", $ligne->Code_client,"</td>", "<td>", $1 igne->nom,"</td>" , "<td>" , 
*$1 igne->prenom, "</td>" , "<td>" , $1 igne->adresse, "</td>" , "<td>" , $1 igne->age, 
*"</td>","<td>", $ligne->mail , "</td></tr>" ; <-© 
} 
echo "</table>"; 
$resul t->f ree_resul t( ) ; 
$idcom->close( ) ; 
} 

?> 

</body> 
</html> 
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II v a 3 clients habitant Paris 



jCode 


client |nom |prenom| adresse |age| mail 


|10 


|Darc |j&anne J9 av d'Orleans|l9 |NULL 


1? 


Marti Pierre- 4 Av Henri 25 martin? :§.ti3cali,£r ; 


\2 


JRapp [Paul J32 Av Foch |44 |rapp@Kbert.com ', 



Figure 16-3 

Lecture des noms des colonnes 
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Insertion de donnees dans la base 



Dans un site interactif, il faut pouvoir enregistrer dans la base de donnees les informations 
saisies par les visiteurs dans un formulaire XHTML en vue d'une reutilisation ulterieure, 
comme dans le cas des coordonnees completes d'un client. 

En vous situant, comme au chapitre 15, dans la perspective d'un site de e-commerce, 
vous allez realiser la saisie puis l'insertion des coordonnees d'un client dans la table 
cl i ent de la base magasi n. Dans un second temps, nous lui permettrons de mettre a jour 
ces informations. 

Insertion des donnees 

Le formulaire XHTML est l'outil privilegie pour saisir de donnees et les envoyer vers le 
serveur PHP/MySQL. Nous disposons desormais de la fonction connexobjetO pour 
effectuer la connexion et de la methode queryO pour l'envoi des requetes. Seule la 
commande SQL INSERT distingue cette operation de celle de lecture de donnees. Le 
script de l'exemple 16-7 realise ce type d'insertion en recuperant les donnees saisies 
par le client dans un formulaire lors d'une commande. Nous commencons par verifier 
l'existence des saisies obligatoires correspondant aux variables $_P0ST['nom'], $_P0ST 
[ ' adresse ' ] et $_P0ST[ ' vi 11 e ' ] (repere O *< Quand une requete est formee en utilisant les 
saisies faites par l'utilisateur, il est preferable d'utiliser le caractere d'echappement pour 
les caracteres speciaux des chaines recuperees dans le tableau $_P0ST, en particulier les 
guillemets, qui peuvent poser probleme dans la requete. Nous disposons pour cela de la 
methode escape_string( ) des objets mysql 1 dont la syntaxe est : 

string $idcom->escape_string(string Schaine) 

La chaine obtenue contient le caractere d'echappement / devant les caracteres speciaux 

NULL, \n, \r, ', " et Control -Z. 

Le script recupere toutes les saisies et les protege (reperes © a ©). La colonne i d_cl 1 ent 
de la table client ayant ete declaree avec l'option AUTO_INCREMENT, il faut y inserer la 
valeur NULL en lui donnant la valeur "\N" (repere ©). Le resultat de la requete est ici un 
booleen permettant de verifier la bonne insertion des donnees dans la table (repere Q). 
Le script doit communiquer son identifiant au client pour qu'il puisse modifier eventuel- 
lement ses donnees. La valeur de la colonne id_client est recuperable a l'aide de la 
propriete i nsert_i d de l'objet my sql i . Ce nombre entier est affiche dans une boite d'alerte 
JavaScript (repere ©). 

<*" Exemple 16-7 Insertion de donnees 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 
<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Saisissez vos coordonnees</title> 
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</head> 
<body> 

<form action= "<?php echo $_SERVER[ ' PHP_SELF' ] ;?>" method="post" 
enctype="applicati on /x-www-form-url encoded "> 
<fieldset> 

<legend><b>Vos coordonnees</bX/legend> 
<table> 

<tr><td>Nom : </tdXtdXinput type="text" name="nom" size="40" maxlength="30"/> 
*</tdX/tr> 

<trXtd>Prenom : </tdXtdXinput type="text" name="prenom" size="40" 
*maxlength="30"/X/tdX/tr> 

<trXtd>Age : </td><td><input type="text" name="age" size="40" maxlength="2"/> 
*</tdX/tr> 

<trXtd>Adresse : </tdXtdXinput type="text" name="adresse" size="40" 
*maxlength="60"/X/tdX/tr> 

<trXtd>Ville : </tdXtdXinput type="text" name="ville" size="40" maxlength="40"/> 
*</tdX/tr> 

<trXtd>Mail : </td><td><input type="text" name="mail " size="40" maxlength="50"/> 
*</tdX/tr> 
<tr> 

<tdXinput type="reset" value=" Effacer "></td> 
<td><input type=" submit" value=" Envoyer "></td> 
</tr> 
</table> 
</fieldset> 
</form> 
<?php 

incl udeC'connexobjet.inc.php" ) ; 
$idcom=connexobjet( 'magasin' , 'my pa ram' ) ; 
if(!empty($_POST['nom'])&& ! empty ( $_P0ST[ 'adresse' ] )&& 
*!empty($_POST['ville'])) <-© 
{ 

$id_client="\N"; <^© 

$nom=$idcom->escape_string($_POST['nom']) ; <— © 

$prenom=$idcom->escape_string($_POST['prenom' ] ) ; <— © 

$age=$idcom->escape_st ring ($_P0ST[' age']) ; <— © 

$adresse=$idcom->escape_string($_POST[ 'adresse' ]) ; <— © 

$ville=$idcom->escape_string($_POST['ville']) ; <— © 

$mail=$idcom->escape_string($_POST['mail ']) ; <— © 

//Requete SQL 

$requete="INSERT INTO client VALUES( '$id_cl ient ' , '$nom' , ' $prenom' , '$age' , 

*»'$adresse' , '$ville' , '$mail ' )"; 

$result=$idcom->query($ requete) ; <— © 

ifC!$result) 



echo $idcom->errno; 
echo $idcom->error ; 
echo "<script type=\"text/javascript\"> 
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alertt ' Erreur : " .$idcom->error. " ' )</script>" ; 



echo "<script type=\"text/javascript\"> 

alertt 'Vous etes enregistre Votre numero de client est 

*-$idcom->insert_id. " ' )</script>" ; <— © 



else {echo "<h3>Formulaire a completer!</h3>";} 

?> 

</body> 

</html> 



La figure 16-4 illustre la page de saisie et la figure 16-5 la boite d'alerte JavaScript qui 
donne son identifiant au client. 



i^, Sai 



;i;sez voz coord onneei: - Jvfozilla Firefox 
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Prenom 
Age : 
Adresse 
Ville: 
Mail : 


■donnees — 




Engels 




Jean 




5E 




Rue cnrm point 




Pans 




php5gjfunhtml.com 




| Effoccr 


| Envoycr | 









Formula ire a completer! 



Figure 16-4 

Formulaire d' insertion de donnees 



An no nee de la page http://localhost 




Figure 16-5 

Boite d'alerte JavaScript donnant le numero de client 
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Mise a jour d'une table 

Un client doit pouvoir modifier ses coordonnees, comme son adresse de livraison ou son 
e-mail. L'exemple 16-8 cree une page contenant un formulaire qui permet la saisie du 
code client dans une zone de texte XHTML (repere Q). L'attribut action de l'element 
<form> renvoie le traitement de la saisie au fichier mysqliex9.php de l'exemple 16-9. La 
page creee est conforme a la figure 16-6. 

; *~ Exemple 16-8 Page de saisies des modifications 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Modifiez vos coordonnees</title> 
</head> 
<body> 

<form action= "mysql iex9.php" method="post" 

*»enctype="application/x-www-form-url encoded "> 

<fieldset> 

<legend><b>Saisissez votre code client pour modifier vos coordonnees</bX/legend> 

<table><tbody> 

<tr> 

<td>Code client : </td> 

<td><input type="text" name="code" size="20" maxlength="10"/X/td><— O 

</tr> 

<tr> 

<td>Modifier : </td> 

<td><input type="submit" val ue="Modifier"/X/td> 

</tr> 

</tbodyX/table> 

</fieldset> 

</form> 
</body> 
</html> 
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Saisissez votre code client pour modifier vos coordonnees 
Code client: 12 



Modifier : ] JModifieri j 



Figure 16-6 

Page de saisie du code client 
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La mise a jour des coordonnees du client est realisee par le script de l'exemple 16-9. 

La premiere inclusion de code PHP renvoie le client vers la page de saisie du code s'il a 
valide le formulaire sans avoir effectue de saisie (repere Q ). Rappelons, comme nous 
l'avons deja vu par ailleurs, que cette partie de code PHP doit figurer en tete du fichier 
car elle utilise la fonction header ( ) pour effectuer la redirection. 

La suite du fichier comporte deux parties distinctes. La premiere cree dynamiquement un 
formulaire permettant la modification des donnees et la seconde enregistre ces donnees 
dans la base. 

Lors du premier appel du fichier de l'exemple 16-9, la condition de l'instruction if 
(repere ©) est necessairement veriflee car la variable $_P0ST['modif'] ne contient rien. 
Elle correspond a la valeur associee au bouton submit du formulaire qui n'est pas encore 
cree. Le script cree une connexion au serveur MySQL pour y lire les coordonnees actuel- 
les du client, dont le code est contenu dans la variable $code issue de la page de saisie de 
l'exemple 16-8 (repere ©). 

La requete SQL selectionne alors toutes les colonnes de la table cl ient dont l'identifiant 
client (colonne id_client de la table client) correspond a la valeur de la variable $code 
(repere ©), dans le but de completer le formulaire avec les donnees actuelles. Cela 
permet de ne saisir que les modifications eventuelles de coordonnees du client, sans 
devoir ressaisir l'ensemble. Ces coordonnees sont lues a l'aide de la methode f etch_row( ) 
de l'objet $result de type mysql i_result, puisque le resultat de la requete SELECT ne 
comporte qu'une seule ligne. Elles sont alors contenues dans la variable $ coord de type 
array. Pour afficher les coordonnees dans le formulaire, vous devez attribuer les valeurs 
de ses elements aux attributs value des differents champs <input /> (repere ©). 

La figure 16-7 montre un exemple de creation dynamique de formulaire pour le client 
dont l'identifiant vaut 12. Le champ cache code du formulaire permet de passer la valeur 
du code client a la partie du script chargee de l'enregistrement des donnees modifiees 
(repere Q). 

L'envoi du formulaire utilise la deuxieme partie du script, qui met a jour les donnees du 
visiteur dans la table client apres avoir verifie l'existence de valeurs pour les champs 
obligatoires du formulaire (repere©). Seules les colonnes nom, adresse, ville et mail 
peuvent etre mises a jour a l'aide de la requete suivante (repere Q) le reste etant force - 
ment inchange : 

I UPDATE client SET nom='$nom' ,adresse='$adresse' ,ville=' $vil 1 e' , 
**-mai 1 = ' $mai 1 ' 
WHERE id_client='$code' 

La verification du resultat de la requete (repere ©) permet d'afficher une boite d'alerte 
JavaScript contenant soit un message d'erreur, soit la confirmation de l'enregistrement. 
La page ne devant pas etre une impasse, le visiteur est redirige d'office vers la page 
d'accueil du site index.html (reperes fl) et ©). 
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Exemple 16-9 Mise a jour de donnees 

<?ph P 

if (empty ($_P0ST[ 'code' ] ) ) { header (" Location: my sql iex8.php") ; } <— O 

?> 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 

<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 
<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<title>Modifiez vos coordonnees</title> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

</head> 

<body> 

<?php 

incl ude( 'connexobjet.inc.php' ) ; 

$idcom=connexobjet( 'magasin' , 'my pa ram' ) ; 

if($_POST['modif ' ] !=' Enregistrer' ) <— Q 

{ 
$code=$idcom->escape_string($_POST['code']); <— © 
//Requete SQL 

$requete="SELECT * FROM client WHERE id_cl ient='$code' " ; <-© 
$ res ult=$idcom->query($ requete) ; 
$coord=$result->fetch_row( ) ; <— © 

//Creation du formulaire complete avec les donnees existantes <— © 
echo "<form action= \"". $_SERVER[ ' PHP_SELF' ] . "\" 
*»method=\"post\"enctype=\"appl ication/x-www-form-urlencoded\">" ; 
echo "<fieldset>" ; 

echo "<legend><b>Modifiez vos coordonnees</bX/legend>" ; 
echo "<table>"; 

echo "<tr><td>Nom : </tdXtdXinput type=\"text\" name=\"nom\" 
•»size=\"40\" maxlength=\"30\" val ue=\"$coord[l]\"/> </tdX/tr>"; 
echo "<trXtd>Prenom : </tdXtdXinput type=\"text\" name=\"prenom\" 
*size=\"40\" maxlength=\"30\" value=\"$coord[2]\"/X/td></tr>": 
echo "<trXtd>Age : </tdXtdXinput type=\"text\" name=\"age\" 
•»size=\"40\" maxlength=\"2\" value=\"$coord[3]\"/X/tdX/tr>" ; 
echo "<trXtd>Adresse : </td><td><input type=\"text\" name=\"adresse\" 
*size=\"40\" maxlength=\"60\" value=\"$coord[4]\"/X/td></tr>": 
echo "<tr><td>Ville : </td><td><input type=\"text\" name=\"vil le\" 
•»size=\"40\" maxlength=\"40\" value=\"$coord[5]\"/X/td></tr>": 
echo "<tr><td>Mail : </td><td><input type=\"text\" name=\"mail \" 
*size=\"40\" maxlength=\"50\" value=\"$coord[6]\"/X/tdX/tr>"; 
echo "<tr><td><input type=\"reset\" value=\" Effacer \"></td> <td><input 
b *type=\"submit\" name=\"modif\" val ue=\ " En regis trer\"X/tdX/tr></ table)" ; 
echo "</fieldset>" ; 

echo "<input type=\"hidden\" name=\"code\" val ue=\"$code\"/>" ; <— © 
echo "</form>"; 
$resul t->close( ) ; 
$idcom->close( ) ; 
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elseif(isset($_POST['non'])&& isset($_POST['adresse'])&& 

*isset($_POST['ville'])) <^@ 

{ 

//ENREGISTREMENT 

$nom=$idcom->escape_string($_POST['nom' ] ) ; 

$adresse=$idcom->escape_string($_POST['adresse' ] ) ; 

$ville=$idcom->escape_string($_POST['ville']) ; 

$mail=$idcom->escape_string($_POST['mail ' ]) ; 

$age=(integer)$_POST['age']; 

$code=$idcom->escape_st ring ($_P0ST[' code']) ; 

//Requete SQL 

$requete="UPDATE client SET nom='$nom' ,adresse='$adresse' , ville= 

*» '$vi lie' .mail ='$mail ' , age=$age WHERE id_cl ient='$code'" ; <— Q 

$result=$idcom->query($ requete) ; 

if(!$result) <-© 

{ 
echo "<script type=\"text/javascript\"> 
alertC ' Erreur : " .$resul t->error. " ' )</script>" ; <— Q) 



echo "<script type=\"text/javascript\"> alert('Vos modifications 
^*sont enregistrees ' ) ;window.location='i ndex.html ' ;</ script)" ; <— © 

} 

$result->close( ) ; 

$idcom->close( ) ; 
} 

else 
{ 

echo "Modifier vos coordonnees! " ; 
} 

?> 

</body> 
</html> 



Verification de I'insertion 

La propriete affected_rows de I'objet mysqli contient le nombre de lignes affectees par une mise a 
jour. Elle peut done nous permettre de savoir si la modification est bien realisee, car elle doit ici etre egale 
a 1. Au repere © de I'exemple 16-9, vous pourriez done ecrire : 

if ($idcom->affected_rows( ) !=1) 
{//Affichage de 1 'erreur 

} 
else 

{//Message de confirmation 
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Modifiez vos coordonnees 


Nom : Enoels 


Prenom : Jean 


Age : GG 


Adresse : Rue compoint 




Ville : Paris 




Mail : php6jgifunhtml.com 


; Effacer ' | En registrar | 
^ 



Figure 16-7 

Formulaire de saisie des coordonnees cree dynamiquement 



Recherche dans la base 

Un site de commerce en ligne doit permettre a ses visiteurs et futurs clients d'effectuer 
des recherches dans la base de donnees afin d'acceder plus rapidement a 1' information 
sur le produit recherche. II doit en outre permettre d'effectuer des statistiques marketing 
a 1' usage du proprietaire du site. Ces recherches concernent aussi bien les sites de 
commerce en ligne que les annuaires et moteurs de recherche des sites de contenu. 

L'exemple 16-10 cree un formulaire classique permettant de saisir un mot-cle et 
d'effectuer des choix de tri des resultats. Les criteres de tri selon le prix, la categorie ou 
l'identifiant d'article sont affiches sous forme de liste deroulante. Le choix de l'ordre 
croissant ou decroissant s'effectue au moyen de deux boutons radio ayant le meme attri- 
but name, ce qui les rend exclusifs l'un de l'autre. 

Le script controle d'abord que le visiteur a saisi un mot-cle dans le formulaire en veri- 
fiant que la variable $_POST['motcle'] n'est pas vide (repere Q). II recupere ensuite le 
mot-cle, la categorie, le critere de tri et l'ordre d' affichage, respectivement dans les varia- 
bles $motcle, $categorie, $ordre et $tn" (reperes © a ©). 

Si la categorie choisie est "tous", la partie de la commande WHERE concernant cette catego- 
rie est vide. Pour les autres choix, elle estegale a "AND categorie=$ categorie" (repere ©). 
La requete de selection suivante (repere Q ) est alors creee par le code : 

"SELECT id_article AS 'Code article', 

designation AS 'Description', 

prix, categorie AS 'Catégorie' 

FROM article WHERE lower(designation) LIKE'%$motcle%"' .Sreqcategorie. 

"ORDER BY $tri $ordre"; 
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On peut remarquer l'utilisation de la fonction MySQL 1 ower( ) qui permet d'effectuer une 
recherche insensible a la casse. De cette facon, que l'utilisateur cherche les mots-cles 
« sony » ou « Sony », il obtiendra bien les resultats presents dans la table articl e. 

L'utilisation d' alias donne un meilleur affichage des titres du tableau de resultats. Apres 
la connexion au serveur, vous recuperez le resultat de la requete dans la variable $ result. 
La lecture des resultats et 1' affichage de toutes les lignes retournees sont realises avec la 
methode fetch„row( ) (repere Q). La figure 16-8 illustre la page creee apres la recherche 
du mot-cle portable. 

Exemple 16-10. Page de recherche d'articles 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 

<title>Rechercher un article dans le magasin</title> 
</head> 
<body> 

<form action= "<?php echo $_SERVER[ ' PHP_SELF' ]?>" method="post" 

*»enctype="appl icati on /x-www-form-url encoded") 

<fieldset> 

<legend><b>Rechercher un article en magasin</b></legend> 

<table> 

<tbody> 

<tr> <td>Mot-clé: </td> 

<td><input type="text" name="motcle" size="40" maxlength="40" 

*-value="<?php $_P0ST[ 'motel e']?>"/X/td> 

</tr> 

<tr> 

<td>Dans la catégorie : </td> 

<td> 

<select name="categorie"> 

<option value="tous">Tous</option> 

<option value="video">Vidéo</option> 

<option value=" informatique">Informatique</option> 

<option val ue= " photo ">Photo</option> 

<option value="divers">Divers</option> 

</select> 

</td> 

</tr> 

<tr> 

<td>Trier par : </td> 

<td> 

<select name="tri"> 

<option value="prix">Prix</option> 

<option value="categorie">Catégorie</option> 

<option value="id_article">Code</option> 

</select> 

</td> 
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</tr> 

<tr><td>En ordre: </td> 

<td>Croissant<input type="radio" name="ordre" value="ASC" checked="checked"/> 

*»Décroissant<input type="radio" name="ordre" value="DESC" /> 

</td> </tr> 

<trXtd>Envoyer</tdXtdXinput type="submit" name="" val ue="OK"/X/tdX/tr> 

</tbody> 

</table> 

</fieldset> 

</form> 
<?php 

if ( !empty($_POST[ 'motcle' ] ) ) <— © 
{ 

include( 'connexobjet.inc.php' ) ; 

$motcle=($_POST['motcle']); <— © 

$ categories ($_P0ST[ 'categorie' ] ) ; <— © 

$ordre=($_POST['ordre']); <— © 

$tri=($_POST['tn"]); <-© 

//Requete SQL 

$reqcategorie=($_POST['categorie' ]=="tous" )?"": "AND categorie='$categorie' " ; <— © 

$requete="SELECT id_article AS 'Code article' .designation AS 'Description' ,prix, 

^categorie AS 'Catégorie' FROM article WHERE lower(designation) 

*LIKE'«motcler".$reqcategorie. "ORDER BY $tri $ordre";<— © 

$idcom=connexobjet( 'magasin' , 'my pa ram' ) ; 

$resul t=$idcom->query($ requete) ; <— @ 

if(!$result) <-© 

{ 

echo "Lecture impossible"; 
} 

else 
{ 

$nbcol=$result->field_count; 
$nbart=$resul t->num_rows ; 
$titres=$result->fetch_fields( ) ; 
echo "<h3> II y a $nbart articles correspondant au mot-clé : $motcle</h3>" ; 

//Affichage des titres du tableau 

echo "<table border=\"l\"> <tr>"; 

foreach($titres as $nomcol=>$val ) 

{ 
echo "<th>", $titres[$nomcol ]->name ,"</th>"; 

} 

echo "</tr>"; 

//Affichage des valeurs du tableau 

for($i=0;$i<$nbart;$i++) 

{ 
$ligne=$result->fetch_row( ) ; 
echo "<tr>"; 

for($j=0;$j<$nbcol ;$j++) 
{ 
echo "<td>" , $1 igne[$j] , "</td>" ; 
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echo 


"</tr>"; 


echo "</table>"; 


$result 


->close( ) 


Sidcom- 


>close( ) ; 


} 




) 




?> 




</body> 




</html> 
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Figure 16-8 

Formulaire de recherche et resultats obtenus 



Les requetes preparees 

Nous avons deja construit des requetes SQL dynamiquement a partir d' informations 
saisies par l'utilisateur dans l'exemple precedent. Les requetes preparees permettent de 
creer des requetes SQL qui ne sont pas directement utilisables mais qui contiennent des 
parametres auxquels on peut donner des valeurs differentes en fonction des besoins, pour 
des appels repetitifs par exemple. Une requete preparee peut se presenter sous la forme 
suivante : 



SELECT prenom.nom FROM client WHERE ville=? AND id_client>=? 
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Dans cette requete, les caracteres ? vont etre remplaces par des valeurs quelconques en 
fonction des besoins du visiteur. 

La demarche a suivre pour utiliser une requete preparee est la suivante : 

1. Ecrire la chaine de requete comme parametre de la methode prepareO de l'objet 
mysql i . Cette derniere retourne un objet de type mysql i_stmt qui represente la requete 
preparee. 

2. Lier les parametres dans l'ordre de leur apparition avec des valeurs ou des variables a 
l'aide de la methode bind_param() de l'objet mysql i_stmt, selon la syntaxe : $mysqli_ 
stmt->bind_param(string $types, $paraml , . . . SparamN). 

La chaine $types est la concatenation de caracteres indiquant le type de chacun des 
parametres. La signification de ces caracteres est presentee au tableau 16-2. 

Tableau 16-2. Signification des caracteres de la chaine $types 

Caractere Definition 

i Entier (integer) 

d Decimal 

s Chaine de caracteres (string) 

b Blob (texte long) 

3. Pour trois parametres qui seraient, dans l'ordre d'apparition dans la requete, un deci- 
mal, une chaine et un entier, la chaine $types serait par exemple "dsi ". 

4. Executer la requete en appelant la methode execute( ) de l'objet mysql 1_stmt. 

5. Pour les requetes preparees qui retournent des resultats, comme SELECT, il faut ensuite 
lier les resultats a des variables PHP, avec la methode bi nd_resul t( ) selon la syntaxe : 
mysql i_stmt->bind_result($varl, . . .$varN) avec autant de parametres qu'il existe de 
colonnes lues dans la requete. L'objet mysql i_result obtenu contient alors toutes les 
lignes du resultat. 

6. Lire ces lignes a l'aide d'une boucle en appliquant la methode fetch ( ) a cet objet et 
utiliser ces resultats pour un affichage avec les noms des variable definies a l'etape 4. 

7. Liberer la memoire occupee par l'objet mysql i_stmt avec la methode free_result( ). 

L'exemple 16-11 presente une application de requete preparee dans laquelle ce sont les 
saisies d'un utilisateur qui determinent les valeurs des parametres et done la requete 
finale. Un formulaire classique demande la saisie d'un nom de ville et d'un numero de 
client (reperes Q et 0) dans le but de trouver tous les clients habitant cette ville et dont 
l'identifiant est superieur ou egal a la valeur saisie. Ces saisies sont d'abord recuperees 
dans les variables $ville et $id_client (reperes © et ©). Apres la connexion a la base, 
nous ecrivons la requete preparee avec la methode prepareO (repere 0), nous lions les 
parametres de type string et integer aux variables $ville et $id_client (repere ©), puis 
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nous executons la requete ainsi completee en appelant la methode execute ( ) (repere ©). 
Comme il s'agit d'une requete SELECT, elle retourne une ou plusieurs lignes contenant 
chacune deux valeurs que nous lions aux variables Sprenom et $nom (repere ©). Les diffe- 
rentes lignes sont alors lues et affichees avec une boucle while en appelant la methode 
fetch () (repere 0), les valeurs cherchees etant contenues dans les variables $prenom et 
$nom. La memoire est ensuite liberee (repere ©) et l'objet mysql 1 supprime (repere ©). 

Exemple 16-11 Utilisation des requetes preparees 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 
<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Recherche de cl ient</title> 
<style type="text/css" > 

div(font-size: 16px;} 
</style> 
</head> 
<body> 
<form method="post" action="mysql iexll.php"> 
<fieldset> 
<legend>Recherche de cl ient</legend> 
<label>Ville </label> 

<input type="text" name="ville" /Xbr /> <— O 
<label>Id_client</label> 
<input type="text" name="id_cl ient" /> <— © 
<input type="submit" val ue="Envoyer" /> 
</fieldset> 
</form> 
</body> 
</html> 
<?php 

if(isset($_POST['ville']) && isset($_POST[ ' id_cl ient ' ]) ) 
{ 
$vi 1 1 e=st rtol ower ( $_P0ST[ ' vi 1 1 e ' ] ) ; <— © 
$i d_cl i ent=$_P0ST[ ' i d_cl i ent ' ] ; <-© 
include( 'connexobjet.inc.php' ) ; 
$idcom=connexobjet( 'magasin' , 'my pa ram' ) ; 

$reqprep=$idcom->prepare("SELECT prenom.nom FROM client WHERE lower(ville)=? 
**AND id_client>=? ");<—© 

$reqprep->bind_param("si " ,$vil le,$id_client) ; <— © 
$reqprep->execute( ) ; <— © 
$reqprep->bind_result($prenom,$nom) ; <— © 

echo "<div><h3>Cl ient(s) habitant a ", ucfi rst($ville) , " et dont 1 'identifiant est 
*»superieur a $id_client</h3>" ; 
//Affichage des resultats 
while ($reqprep->fetch()) <— © 
{ 
echo "<h3> $prenom $nom</h3>"; 
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echo "</div>"; 

$reqprep->free_resul t( ) ; <— © 
$idcom->close( ) ; <— © 



} 

?> 



Avec notre base de donnees magasin et les parametres « Paris » et « 3 », nous obtenons 
par exemple l'affichage presente a la figure 16-9 
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Pierre Marti 
Jeanne Dare 






Figure 16-9 

Resultats d'une requete preparee 



Les transactions 

Dans 1' exemple de notre base magasin, si un client effectue un achat, il faut realiser 
simultanement deux insertions : une dans la table commande et une dans la table 1 igne. Si, 
pour une raison quelconque, materielle ou logicielle, la seconde insertion n'est pas reali- 
sed alors que la premiere Test deja, la base contiendra une incoherence car il existera une 
commande ne comportant aucune ligne. L'inverse ne serait guere preferable car, dans ce 
cas, il existerait une ligne qui ne serait reliee a aucune commande. Les transactions 
permettent de gerer ce genre de situation en effectuant des commandes « tout ou rien » ce 
qui, en pratique pour notre exemple ci-dessus, signifie que si l'une des deux requetes 
n'est pas executee, aucune ne Test. L'integrite de la base s'en trouve preservee. 

Le langage SQL possede des commandes qui permettent de gerer les transactions, mais 
l'extension mysqli nous fournit des methodes qui permettent de gerer les transactions 
sans y faire appel. 
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Dans l'exemple 16-12, nous illustrons la procedure a suivre pour effectuer deux requetes 
INSERT dans la table arti cl e. Par defaut, le mode autocommi t de MySQL est active, ce qui 
signifie que chaque requete est automatiquement validee. II nous faut done le desactiver 
au moyen de la methode autocommi to de l'objet mysqli avec pour parametre la valeur 
FALSE (repere ©). A partir de cet instant, les deux requetes d'insertion que nous voulons 
realiser (reperes © et ©) ne seront validees que si nous effectuons explicitement la vali- 
dation au moyen de la methode commit (repere ©), ou bien l'ensemble sera annule en 
appelant la methode rol 1 backO de l'objet mysql i (repere ©). Pour choisir de valider ou 
annuler les insertions, nous comptons le nombre total de lignes inserees dans la base en 
lisant la propriete af f ected_rows (reperes © et ©). S'il est bien egal a 2, la validation est 
effectuee (repere©), sinon tout est annule et un message d'information s'affiche 
(repere ©). 

Pour tester l'efficacite du mecanisme, il suffit de creer une erreur en ecrivant par exemple 
dans la variable $requete2 le nom articles, au lieu de article, comme nom de table 
inexistante. L'affichage de la table article avec phpMy Admin permet de verifier que 
me me la premiere requete, qui etait correcte, n'a pas ete executee. 

Exemple 16-12 Insertions avec transaction 

<?php 

incl ude( 'connexobjet.inc.php' ) ; 

$idcom=connexobjet( 'magasin' , 'my pa ram' ) ; 

$idcom->autocommit( FALSE) ; <— O 

$requetel="INSERT INTO article VALUES OAZERT', 'Lecteur MP3', 59.50, 

'•'divers');"; <-© 

$requete2="INSERT INTO article VALUES OQSDFG'. 'Bridge Samsung 10 Mo', 358.90, 

^'photo');"; <— © 

//pour empecher la validation ecrire articles au lieu de article 
//it************************************************************* 

$idcom->query($requetel) ; 
$nb=$idcom->affected_rows; <— © 
echo "LIGNES INSEREES" ,$nb,"<hr />"; 
$idcom->query($requete2) ; 
$nb+=$idcom->affected_rows; <— © 
if($nb==2) 
{ 

$idcom->commit( ) ; <— © 

echo $nb," lignes inserees"; 
} 

else 
{ 

$idcom->rollback( ) ; <— © 

echo "transaction annulee"; 
} 
?> 
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Memo des methodes et proprietes 
Classe mysqli : methodes 



mysqli ( [string $host [, string $username [, string $passwd [, string $base [, int $port [, 

string $socket]]]]]] ) 

} 

Cree un objet mysqli. 

boolean autocommit ( boolean $mode ) 

Active ($mode =TRUE) ou desactive ($mode=FALSE) le mode autocommit. 

boolean change_user ( string $user, string $password, string $base ) 

Change I'utilisateur de la connexion et retourne TRUE en cas de reussite et FALSE sinon. 

boolean close (void) 

Ferme la connexion et retourne TRUE en cas de reussite et FALSE sinon. 

boolean commit ( void ) 

Valide la transaction courante et retourne TRUE en cas de reussite et FALSE sinon. 

string escape_string ( string $chaine ) 

Cree unechaine SQL valide qui pourraetre utilisee dans une requete SQL. Lachainede caracteres Schaine estenco- 
dee en une chaine SQL echappee, en tenant compte du jeu de caracteres courant de la connexion. 

boolean kill ( int $processid ) 

Demande au serveur de terminer un thread MySQL identifie par son identifiant. 

boolean multi_query ( string $query ) 

Execute une ou plusieurs requetes, rassemblees dans le parametre query par des points-virgules. 

boolean ping ( void ) 

Teste la connexion pour s'assurer que le serveur est bien en fonctionnement. S'il ne fonctionne pas et que I'option globale 
mysql i . reconnect est activee, une connexion automatique sera tentee avec les derniers parametres utilises. 

objet mysql i_stmt prepare ( string $query ) 

Prepare une requete SQL et retourne un objet mysql i_stmt. 

divers query ( string $query [, int $mode] ) 

Execute une requete sur la base de donnees. $mode est une constante qui vaut MYSQLI_USE_RESULT ou MYSQLI_STORE_ 
RESULT (par defaut), suivant le comportement desire. Retourne TRUE en cas de succes, FALSE en cas d'echec. Pour 
SELECT, SHOW, DESCRIBE ou EXPLAIN retourne un objet mysql i_result. 

boolean rollback ( void ) 

Annule la transaction courante. 

boolean select_db ( string $base ) 

Selectionne une base de donnees. 

string stat ( void ) 

Retourne une chaine de caracteres contenant des informations sur la connexion ouverte : le temps de fonctionnement, 
exprime en secondes, le nombre de threads courant, le nombre de commandes, les tables rechargees et ouvertes. 
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objet mysql i_resul t store_result ( void ) 

Stocke un ensemble de resultats dans un objet mysql i_resul t a partir de la derniere requete. 



Classe mysqli : proprietes 



integer affected_rows 

Contient le nombre de lignes affectees par la derniere requete INSERT, UPDATE, REPLACE ou DELETE. 

integer errno 

Contient un code d'erreur pour la derniere commande SQL. 

integer error 

Contient une chaine decrivant la derniere erreur. 

integer field_count 

Contient le nombre de colonnes concernees dans la derniere requete. 

integer insert_id 

Contient I'identifiant automatiquement genere pour un attribut declare AUT0_I NCREMENT ou sinon. 

thread_id 

Contient I'identifiant du thread pour la connexion en cours. 

integer warning_count 

Contient le nombre d'avertissements generes par la derniere requete. 

Classe mysqli_result : methodes 

boolean close ( void ) 

Supprime I'objet resultat. 

boolean data_seek(integer N) 

Deplace le pointeur interne de resultat a la position N. 

divers fetch_array ( [integer $type] ) 

Retourne un tableau qui correspond a la ligne recuperee, ou NULL s'il n'y a plus de ligne dans le resultat. Le parametre 
$type determine le type du tableau ; il vaut MYSQLI_ASSOC, MYSQLI_NUM ou MYSQLI_BOTH respectivement pour 
obtenir un tableau associatif, indice ou mixte. 

array fetch_assoc ( void ) 

Retourne une ligne de resultat sous forme de tableau associatif. 

object fetch_field ( void ) 

Retourne un objet qui contient les caracteristiques d'un attribut de table. 

array fetch_fields ( void ) 

Retourne un tableau d'objets qui contient les caracteristiques de tous les attributs de table presents dans une requete. 
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object fetch_object (void) 

Retourne un objet dont les proprietes sont les noms des colonnes utilisees dans la requete ou NU LL s'il n'y a plus de ligne 
dans le resultat. 

divers fetch_row ( void ) 

Retourne un tableau indice contenant une ligne de resultat ou NULL s'il n'y a plus de ligne de resultat. 

boolean field_seek ( i nt N ) 

Place le pointeur de resultat sur le champ N. 

void free_result ( void ) ou void close ( void ) 

Libere la memoire associee a I'objet resultat. 

Classe mysqli_result : proprietes 

integer field_count 

Contient le nombre de colonnes pour la derniere requete. 

int num_rows 

Retourne le nombre de lignes d'un resultat. 

Classe mysqli_stmt : methodes 

boolean bind_param ( string $types, divers $varl [...divers $varN] ) 

Lie des variables a une requete SQL preparee avec la methode prepare; ). 

boolean bind_result (divers $varl [....divers $varN] ) 

Associe des variables a un resultat de requete preparee et retourne TRUE en cas de reussite ou FALSE sinon. 

boolean close ( void ) 

Termine une requete preparee et retourne TRUE en cas de reussite ou FALSE sinon. 

void data_seek ( integer N) 

Deplace le pointeur de resultat a la position N. 

boolean execute ( void ) 

Execute une requete preparee et retourne TRUE en cas de reussite ou FALSE sinon. 

boolean fetch ( void ) 

Lit des resultats depuis une requete MySQL preparee dans les variables liees. 

void free_result ( void ) 

Libere le resultat de la memoire. 

divers prepare ( string Irequete ) 

Prepare une requete SQL et retourne TRUE en cas de succes, FALSE en cas d'echec. 

boolean reset ( void ) 

Annule une requete preparee et retourne TRUE en cas de succes, FALSE en cas d'echec. 
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Classe mysqli_stmt : proprietes 



integer affected_rows 

Contient le nombre total de lignes concernees par la derniere requete. 

integer errno 

Contient un code erreur pour la derniere requete preparee. 

string error 

Contient la description de la derniere erreur. 

integer field_count 

Contient le nombre de colonnes dans la requete. 

integer insert_id 

Contient I'identifiant genere par la derniere requete INSERT pour la colonne AUTO_INCREMENT. 

integer num_rows 

Contient le nombre de lignes d'un resultat de requete preparee. 

integer param_count 

Contient le nombre de parametres necessaires dans la requete preparee. 



Exercices 



Tous les exercices ci-dessous portent sur la base de donnees voitures creee aux chapi- 
tres 13 et 14. lis sont identiques a ceux du chapitre 15, mais vous devez les realiser 
uniquement avec l'extension mysql i objet. 

Exercice 1 

Creez un script permettant d'afficher le contenu de la table model e dans un tableau 
XHTML. Les resultats doivent etre tries par marque. 

Exercice 2 

Creez un formulaire permettant l'insertion de nouvelles donnees dans la table model e. 

Exercice 3 

Creez un formulaire permettant l'insertion simultanee des coordonnees d'une personne 
dans les tables proprietaire et cartegrise. II doit contenir les zones de saisie des coor- 
donnees de la personne et la liste des modeles d'une marque creee dynamiquement a 
partir de la saisie de la marque. 

Exercice 4 

Creez un formulaire de recherche permettant de retrouver tous les proprietaries d'un type 
de vehicule de marque et de modele donnes. Affichez les resultats sous forme de tableau 
XHTML. 
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Exercice 5 

Creez un formulaire de recherche permettant de retrouver tous les vehicules possedes par 
une personne donnee. Affichez les resultats sous forme de tableau XHTML. 

Exercice 6 

Reecrivez entierement le code de l'exercice 5 en recuperant tous les resultats dans des 
objets et en manipulant leurs proprietes. 

Exercice 7 

Refaire l'exercice 4 en utilisant une requete preparee. 

Exercice 8 

Refaire l'exercice 3 en utilisant une transaction pour s'assurer que les donnees sont bien 
inserees dans les differentes tables. 
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PDO et MySQL 



PDO {PHP Data Objects) est une extension qui offre une couche d' abstraction de 
donnees introduite dans PHP 5, ce qui signifie qu'elle n'est pas liee, comme les exten- 
sions mysql ou mysqli que nous avons abordees dans les deux chapitres precedents, 
mais independante de la base de donnees utilisee. Grace a elle, le code devient portable 
tres facilement, c'est-a-dire qu'elle modifie uniquement la ligne de connexion, d'une 
base de donnees MySQL a SQLite, PostgreSQL, Oracle et d'autres encore par exemple. 
PDO offre done aussi bien l'avantage de la portabilite, de la facilite d' utilisation que de 
la rapidite. 

L'extension PDO comprend les trois classes suivantes : 

• La classe PDO, qui permet de creer des objets representant la connexion a la base et qui 
dispose des methodes permettant de realiser les fonctions essentielles, a savoir 1' envoi 
de requete, la creation de requetes preparees et la gestion des transactions. 

• La classe PDOStatement, qui represente, par exemple, une requete preparee ou un resul- 
tat de requete SELECT. Ses methodes permettent de gerer les requetes preparees et de 
lire les resultats des requetes. 

• La classe PDOException qui permet de gerer et d'afficher des informations sur les 
erreurs a l'aide d' objets. 

Ce chapitre reprend exactement la meme demarche que le precedent en utilisant exclusi- 
vement PDO ; nous allons y reprendre les differents exemples des chapitres 15 et 16 et 
voir comment obtenir les memes resultats via un acces objet PDO. II peut done etre aborde 
independamment des deux chapitres precedents. 
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Connexion au serveur MySQL 

Bien entendu, la premiere chose a faire est de se connecter au serveur. Pour cela nous 
creons un objet de la classe PDO en utilisant le constructeur de la classe PDO dont les para- 
metres changent selon le serveur auquel nous nous connectons. Par exemple : 

• Pour MySQL : 

$idcom= new PD0( "mysql :host=$host ;dbname=$base ,$user,$pass) ; 

• Pour SQLite : 

$idcom= new PDOC'sql ite2:/chemin/rep/$base") ; 

• Ou encore pour PostgreSQL, que nous n'utiliserons pas, ce qui illustre la portabilite de 
PDO: 

I$idcom= new PDOC "pgsql :host=$host port=5432 dbname=$base user=$user 
**password=$pass" ) . 

Dans ces exemples, $idcom est un objet PDO. Shost, $user, $pass et $base, quant a eux 
designent, comme dans les chapitres precedents, le nom du serveur, l'utilisateur, le mot 
de passe et le nom de la base. 

Nous pouvons egalement reutiliser le fichier myparam.inc.php cree au chapitre 15, conte- 
nant les parametres de connexion (ci-dessous en local) : 

<** Exemple 1 7-1 . Le fichier myparam.inc.php 

<?php 

defineC'MYHOST", "local host"); 

define("MYUSER","root"); 

defineC'MYPASS",""); 

?> 

L'objet $idcom representant la connexion sera utilise directement ou indirectement pour 
toutes les operations a effectuer sur la base. Si la connexion n'est pas effectuee, la varia- 
ble $idcom est un booleen qui contient la valeur FALSE, ce qui permet de tester si la 
connexion est bien realisee. 

La connexion prend fin quand 1' execution du script PHP est terminee, mais on peut 
mettre fin explicitement a la connexion pour liberer le serveur MySQL. Si les resultats 
d'une requete sont entierement recuperes, la connexion peut en effet etre detruite en 
donnant a la variable $idcom la valeur NULL. 



Selection de la base via SQL 

Comme nous I'avons vu au chapitre 15, vous pouvez aussi selectionner une base en envoyant la requete 
"use nom_base" au serveur a I'aide de la methode queryt ) detaillee dans les sections suivantes. 



La structure de principe d'un script accedant a MySQL est done la suivante : 
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<?php 

//Inclusion des parametres de connexion 

incl ude_once( "myparam.inc.php" ) ; 

//Connexion au serveur 

$dsn="mysql :host=" .MYHOST. " ;dbname=" .$base; 

$user=MYUSER; 

$pass=MYPASS; 

$idcom = new PDO($dsn,$user,$pass) ; 

//Controle de la connexion 

if(!$idcom) 

{ 

echo "Erreur"; 

} 
//it******************************* 

//Requetes SQL sur la base choisie 

//Lecture des resultats 
//a******************************** 

//Fermeture de la connexion 

$idcom=NULL; 

?> 

Comme nous l'avons fait pour l'acces procedural a MySQL, nous avons interet a creer 
une fonction de connexion au serveur que nous reutiliserons systematiquement dans 
tous les exemples qui suivent. C'est l'objet de l'exemple 17.2 qui cree la fonction 
connexpdo( ), dont les parametres sont le nom de la base dans la variable $base et le nom 
du fichier .inc.php qui contient les parametres de connexion dans la variable $param. 

La fonction inclut d'abord les parametres de connexion (repere ©). definit la chaine 
DSN (Data Source Name) pour MySQL (repere @), puis cree un objet PDO dans un bloc 
try (repere ©). En cas d'echec, un bloc catch cree un objet PDOException (repere ©) qui 
permet d'afficher un message d'erreur en appelant la methode getMessaget ) (repere 0). 
Si la connexion est bien realisee elle retourne l'objet $idcom ou FALSE dans le cas 
contraire. 

Exemple 17-2. Fonction de connexion au serveur 

<?php 

function connexpdo($base,$param) 

{ 

include_once($param. " .inc.php") ; <— O 

$dsn="mysql : host=" .MYHOST. " ; <-© 
dbname=" .$base; 

$user=MYUSER; 

$pass=MYPASS; 

try 

{ 
Sidcom = new PDO($dsn,$user,$pass) ; <— Q 
return Sidcom; 

} 

catch(PDOException Sexcept) <— O 



PHP 5 



echo"Echec de la connexion" ,$except->getMessage( ); <— © 

return FALSE; 

exitO; 
} 
} 
?> 

Chacun de vos scripts d'acces a la base doit de ce fait contenir les lignes suivantes : 

Iincl udeC'connexpdo.inc.php") 
$idcom = connexpdo ( "nom_base" , "myparam ") ; 

L'operation de connexion est done la aussi geree en 2 lignes, quel que soit le script ou le 
type de base. 



Envoi de requetes SQL au serveur 

Les differentes operations a realiser sur la base MySQL impliquent 1' envoi de requetes 
SQL au serveur. 

Pour envoyer une requete au serveur, nous avons le choix entre plusieurs methodes. 

Pour celles qui ne retournent pas de resultats, il existe la methode exec( ) des objets PDO 
dont la syntaxe est la suivante : 

integer $idcom->exec(string requete) 

Elle est utilisee pour les requetes INSERT, UPDATE ou DELETE par exemple. Elle retourne 
simplement un entier qui correspond au nombre de lignes concernees par la requete. 

Pour les requetes qui vont retourner des resultats, il faut employer la methode query ( ), 
dont la syntaxe est : 

object $idcom->query(string Srequete) 

Elle retourne FALSE en cas d'erreur ou, sinon, un objet de la classe PDOStatement represen- 
tant 1' ensemble des lignes de resultats - pour lequelles il faut ensuite appeler les metho- 
des specialisees pour afficher les valeurs. En resume, un script d'envoi de requetes se 
presente sous la forme suivante : 

<*" Exemple 17-3 Envoi type de requete 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 
<title>Insertion et lecture de la table cl ient</title> 
</head> 
<body> 
<?php 
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incl ude_once( "connexpdo.inc.php") ; <— O 

$idcom=connexpdo( "magasin" , "my pa ram") ; <— © 

//Requete sans resultats 

$requetel="UPDATE client SET age=43 WHERE id_cl ient=7" ; <-© 

$nb=$idcom->exec($requetel); <— O 

echo "<p>$nb ligne(s) modifiée(s)<hr /></p>";<— © 

//Requete avec resultats 

$requete2="SELECT * FROM client ORDER BY nom";<-© 

$result=$idcom->query($requete2) ; <— © 

if(!$result) <-© 

{ 

$mes_erreur=$idcom->errorInfo( ) ; 

echo "Lecture impossible, code", $idcom->errorCode( ) ,$mes_erreur[2] ; 
} 

else <^© 
{ 

while ($row = $result->fetch(PDO: : FETCH_NUM) ) 

{ 
foreach($row as $donn) 
{ 
echo $donn, " " ; 



) 

echo "<hr />"; 
} 

$result->closeCursor( ) ; <— © 
} 

$idcom=null ; 
?> 

</body> 
</html> 

II effectue successivement l'inclusion du fichier connexpdo.inc.php (repere ©), la 
connexion au serveur (repere ©), l'ecriture d'une premiere requete SQL dans la variable 
$requetel (repere ©) et son envoi a l'aide de la methode exec( ), qui retourne le nombre 
de lignes affectees dans la variable $nb (repere ©) et son affichage (repere ©). Une 
seconde requete contenant la commande SELECT (repere ©) est envoy ee via la methode 
queryO qui retourne un resultat dans la variable Sresult -qui est un objet de type 
PDOStatement (repere ©). Un test permet de verifier la bonne execution de la requete et 
1' affichage des resultats au moyen de methodes que nous developperons dans les sections 
suivantes (reperes © et ©). Enfin, pour liberer la memoire occupee par le resultat 
obtenu, nous utilisons la methode closeCursorO de l'objet PDOStatement, surtout utile 
avant d'envoyer une nouvelle requete SELECT au serveur (repere ©). 



Lecture du resultat d'une requete 

Pour les operations d'insertion, de suppression ou de mise a jour des donnees dans une 
base, il est utile de verifier si la requete a bien ete executee ou, comme dans l'exem- 
ple 17-3, de verifier le nombre de lignes affectees. 



PHP 5 



En revanche, lorsqu'il s'agit de lire le resultat d'une requete contenant la commande 
SELECT, la methode queryO retourne un objet de type PDOStatement identifie dans nos 
exemples par la variable $resul t. La classe PDOStatement offre une variete de methodes qui 
permettent de recuperer des donnees sous des formes diverses, la plus courante etant un 
tableau mais cela peut egalement etre un objet. 

Lecture a I'aide d'un tableau 

La methode des objets PDOStatement la plus courante pour lire des donnees dans un 
tableau est fetch ( ) dont la syntaxe est : 

array $resul t->fetch(integer type) 

Elle retourne un tableau qui peut etre indice (si la constante type vaut PDO: :FETCH_NUM), 
associatif (si type vaut PDO: :FETCH_ASSOC), dont les cles sont les noms des colonnes ou 
les alias de la table interrogee, ou encore mixte contenant a la fois les indices et les cles 
(si type vaut PDO: :FETCH_BOTH). Pour lire toutes les lignes du resultat, il faut ecrire une 
boucle (while par exemple) qui effectue un nouvel appel de la methode fetch () pour 
chaque ligne. Cette boucle teste s'il y a encore des lignes a lire, la methode fetch () 
retournant la valeur NULL quand il n'y en a plus. Pour lire et afficher chaque ligne, nous 
utilisons ensuite une boucle foreach. Notez encore une fois que si le tableau retourne est 
indice, l'indice correspond au premier attribut ecrit dans la requete, et ainsi de suite. 

Nous pouvons egalement recuperer toutes les lignes de resultats dans un seul tableau 
multidimensionnel pour lequel le premier niveau est indice de a N-l pour lire N lignes, 
chaque element etant lui meme un tableau qui peut etre indice, associatif ou mixte selon 
la valeur du parametre type qui prend les memes valeurs que pour la methode fetch ( ). II 
s'agit de la methode f etchAl 1 ( ) qui sera mise en oeuvre dans l'exemple 17-5 et dont la 
syntaxe est : 

array $resul t->fetchAl 1 (integer type) 

L'exemple 17-4 met cette methode en pratique dans le but d'afficher le contenu de la 
table article de la base magasin dans un tableau XHTML. Apres l'inclusion de la fonction 
de connexion (repere ©>. puis son appel sur la base magasin (repere ©), nous ecrivons la 
requete SQL de selection (requete©). L' envoi de la requete avec la methode queryO 
permet de recuperer un objet $result ou FALSE en cas d'echec (repere ©). Un test sur la 
variable $result (repere©) permet d'afficher un message d'erreur (repere©) ou le 
contenu de la table (repere ©). Nous recuperons d'abord le nombre d' articles dans la 
table grace a la methode rowCountO de l'objet PDOStatement (repere©) et affichons ce 
nombre dans un titre <h4> (repere ©). Une boucle whi 1 e permet de lire une ligne a la fois 
dans un tableau indice (repere ©), puis une boucle foreach permet d'afficher chacune 
des valeurs du tableau dans un tableau XHTML (repere©). L'objet $result est alors 
supprime (repere ©) et la connexion fermee (repere ©). La figure 17-1 illustre l'affi- 
chage obtenu dans un navigateur. 
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Exemple 17-4. Lecture de la table article 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 
<title>Lecture de la table article</title> 
<style type="text/css" > 

table {border-style:double;border-width: 3px;border-color:red; 
*»background-color: yellow;} 
</style> 
</head> 
<body> 
<?php 

incl udeC'connexpdo.inc.php" ) ; <— O 
if($idcom=connexpdo("magasin" , "my pa ram" ) ) <— © 
{ 
$requete="SELECT * FROM article ORDER BY categorie" ; <^© 
$resul t=$idcom->query($requete) ; <— O 
if(!$result) <-© 
{ 

$mes_erreur=$idcom->errorInfo( ) ; 

echo "Lecture impossible, code", $idcom->errorCode( ) ,$mes_erreur[2] ; <— © 
} 

else ^© 
{ 

$nbart=$result->rowCount( ) ; <— @ 

echo "<h3> Tous nos articles par catégorie</h3>" ; 
echo "<h4> II y a $nbart articles en magasin </h4>";<— © 
echo "<table border=\"l\">" ; 

echo "<tr><th>Code article</th> <th>Description</th> <th>Prix</th> 
*»<th>Catégorie</thX/tr>" ; 
while($ligne=$result->fetch(PDO::FETCH_NUM)) <-© 
{ 
echo "<tr>"; 

foreach($ligne as $valeur) <— © 
{ 

echo "<td> $valeur </td>"; 
} 

echo "</tr>"; 
} 

echo "</table>"; 
} 

$result->closeCursor( ) ; <— © 
$idcom=null ; <— © 
} 

?> 

</body> 
</html> 
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Fichier Edition Affiehage Historique Marque-pages Outiis 1 
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Tous nos articles par categorie 

II y a 13 articles en magasln 



|Code article | Description 


| Prix | Categorie 


^MIKSO 


[Nikon P80 


479.00 photo 


|CA300 


|Canon EOS 3000V zoom 28/80 


329.00 photo 


NIK55 


[Nikon F55+zoom 28/80 


269.00 photo 


|qsdfg 


[Bridge numerique Samsung 


358.90 photo 


JCP100 


[Camescope Panasonic SV-AV 100 1 1490.00 [video 


JCS330 


|Camescope Sony DCR-PC330 


1629.00 video 


JHP497 


[PC Bureau HP497 ecran TFT 


1500.00 infonnatique 


JDEL30 


[Portable Dell X300 


1715.00 informatique 


|SAX15 


[Portable Samsung XI 5 XVM 


1999.00 informatique 


JSOXMP 


[PC Portable Sony Zl-XMP 


2399.00 informatique 


|e>VD75 


|DVE> vicrgc par 3 


17.50 divers 


|CAS07 


[Cassette DV60 par 5 


|26.90 | divers 


JAZHRT 


[Lecteur MF3 


59.5U divers 



http://vali dator.w3.org/check7uri-referer 



Figure 17-1 

Lecture de la table article 



Lecture des noms de colonnes. 

Dans l'exemple precedent, les titres des colonnes du tableau XHTML sont ecrits a 
l'avance dans le script. Nous pouvons automatiser cette operation en recuperant les noms 
des colonnes de la table interrogee, ou les alias figurant dans les requetes SQL, ce qui 
peut permettre la realisation d'un affichage dynamique. 

Pour cela, nous allons lire les resultats dans un tableau associatif et recuperer les noms 
des colonnes de la table ou les alias eventuels, en recuperant les cles de ce tableau dans 
un autre tableau et en lui appliquant la fonction PHP array_keys( ) (voir le chapitre 5). 

L'exemple 17-5 illustre cette possibilite a partir d'une requete SQL selectionnant les 
articles de la table article dont la designation contient le mot « Sony », en definissant des 
alias pour les noms des colonnes (repere Q)- Apres l'envoi de la requete par la methode 
query( ), nous recuperons le resultat (repere ©) puis son nombre de lignes (repere ©). 
Nous utilisons ici la methode f etchAl 1 ( ) pour recuperer toutes les lignes dans un unique 
tableau indice $tabresul t (repere ©). Chacun des elements de ce tableau est lui meme un 
tableau associatif car nous avons passe la constante PDO: :FETCH_ASSOC en parametre a la 
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methode fetchAHO. Par exemple, le tableau $tabresult[0] contient les donnees de la 
premiere ligne du resultat ; il est associatif done ses cles correspondent aux noms des 
colonnes ou alias precises dans la requete SQL. Le tableau $titres, retourne par la fonc- 
tion array_keys() (repere ©), ne contient done que ces cles que nous lisons dans une 
boucle foreach pour afflcher les en-tetes du tableau XHTML (repere ©). Deux boucles, 
for puis foreach (reperes © et ©), permettent la lecture du tableau multidimensionnel 
$tabresult pour l'affichage des donnees. Les objets connexion et resultat sont ensuite 
detruits (reperes © et ©). 

Exemple 17-5. Lecture automatique des noms des colonnes 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 

<title>Lecture de la table article</title> 

<style type="text/css" > 

table {border-style:double;border-width: 3px;border-color: red; 

^•background-color: yellow;} 

</style> 
</head> 
<body> 
<?php 

incl udeC'connexpdo.inc.php") ; 
$idcom=connexpdo( "magasin" , "my pa ram") ; 
// 

$requete="SELECT id_article AS 'Code article' .designation AS 'Designation' ,prix 
*»AS 'Prix Unitaire' .categorie AS 'Categorie' FROM article WHERE designation 
*LIKE •SSonyX' ORDER BY categorie" ; <-© 
$result=$idcom->query($requete) ; <— © 
if(!$result) 
{ 

$mes_erreur=$idcom->errorInfo( ) ; 

echo "Lecture impossible, code", $idcom->errorCode( ) , $mes_erreur[2] ; 



$nbart=$result->rowCount( ) ; <— © 

$tabresult=$result->fetchAll(PDO::FETCH_ASSOC); <-© 

//recuperation des noms des colonnes ou des alias 

$titres=array_keys($tabresult[0] ) ; <— © 

//Affichage des titres de la page 

echo "<h3> Tous nos articles de la marque Sony</h3>"; 

echo "<h4> II y a $nbart articles en magasin </h4>"; 

echo "<table border=\"l\"> <tr>"; 

//Affichage des titres du tableau 

foreach($titres as Snomcol ) <— © 

{ 

echo "<th>", htmlentities($nomcol ) ,"</th>"; 
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) 

echo "</tr>"; 

//Affichage des lignes de donnees 

for($i=0;$i<$nbart;$i++) <— Q 

{ 

echo "<tr>"; 

foreach($tabresult[$i] as $valeur)<— © 

{ 
echo "<td> $valeur </td>"; 

} 

echo "</tr>"; 
} 
echo "</table>"; 



o 



} 

$result->closeCursor( ) ; 

$idcom=null ; <— (J) 

?> 

</body> 

</html> 



La figure 17-2 illustre les resultats obtenus. 
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Lecture des noms des colonnes 



Recuperation des valeurs dans un objet 

Les objets de type PDOStatement possedent le methode fetchObjectC ), dont la syntaxe est : 

object $result->fetchObject() 

A chaque appel de cette methode, l'objet retourne represente une ligne de resultat et 
possede autant de proprietes qu'il existe d'attributs dans la requete SQL SELECT ; les noms 
de celles ci sont d'ailleurs ceux des colonnes de la table ou des alias eventuels. 
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Si nous recuperons une ligne de resultat dans la variable : 

$ligne=$result->fetchObject() 
La valeur d'un attribut nom est lue avec la syntaxe : 

$1 igne->nom 

L'exemple 17-6 realise la recherche et l'affichage dans un tableau XHTML de tous les 
clients qui habitent Paris en utilisant cette methode. En revanche, pour afficher les titres 
du tableau, nous n'allons pas utiliser la methode developpee dans l'exemple precedent. 
Dans la requete SQL, nous definissons des alias qui vont correspondre aux en-tetes 
(repere©). Pour les lire, nous appelons la methode fetchObjectO pour l'objet $result 
(repere©) et recuperons la premiere ligne de resultat dans la variable $1 i gne. Cette 
variable est un objet de type StdCl ass (la classe de base de PHP 5) dont les proprietes ont 
pour nom ceux des colonnes ou des alias de la requete. Comme il s'agit d'un objet, nous 
pouvons le parcourir au moyen d'une boucle foreach pour ecrire les en-tetes du tableau 
XHTML (repere ©). Les valeurs associees ne nous interessent pas encore ici. Pour recu- 
perer le tableau des donnees nous utilisons une boucle do . . .whi 1 e (repere ©), ce qui nous 
permet de ne pas perdre les valeurs de la premiere ligne par un deuxieme appel de la 
methode fetchObjectO. Chaque nouvelle ligne est obtenue dans la condition de l'instruc- 
tion whi 1 e (repere ©). 

Exemple 17-6. Lecture des donnees dans un objet 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 
<title>Lecture de la table cl ient</title> 
<style type="text/css" > 

table {border-style :double;border-width:3px; border-col or: red; 
^►background-col or: yellow; } 
</style> 
</head> 
<body> 
<?php 

incl udeC'connexpdo.inc.php") ; 
$idcom=connexpdo( "magasin" , "my pa ram") ; 

$requete="SELECT id_client AS 'Code_client' , nom, prenom.adresse, age, mail 
*FR0M client WHERE ville ='Paris' ORDER BY nom";<-0 
$ res ult=$idcom->query($ requete) ; 
if(!$result) 
{ 

$mes_erreur=$idcom->errorInfo( ) ; 

echo "Lecture impossible, code", $idcom->errorCode( ) ,$mes_erreur[2] ; 



$nbart=$result->rowCount( ) ; 
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$ligne=$result->fetchObject(); <— © 

echo "<h3> II y a $nbart clients habitant Pari s</h3>" ; 

//Affichage des titres du tableau 

echo "<table border=\"l\"> <tr>"; 

foreach($ligne as $nomcol=>$val ) <— © 

{ 
echo "<th>", Snomcol ,"</th>"; 

} 

echo "</tr>"; 

//Affichage des valeurs du tableau 

echo "<tr>"; 

//il faut utiliser do while car sinon on perd la premiere ligne de donnees 

do 

{ 
echo"<td>", $ligne->Code_client,"</td>", "<td>", $1 igne->nom,"</td>" , "<td>" , 
*$1 igne->prenom, "</td>" , "<td>" , $1 igne->adresse, "</td>" , "<td>" , $1 igne->age, 
*"</td>","<td>", $ligne->mail , "</td></tr>" ; <-© 

} 

while ($ligne = $result->fetchObject( ) ) ; <— 

echo "</table>"; 

$resul t->closeCursor( ) ; 

$idcom=null ; 
} 

?> 

</body> 
</html> 
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Figure 17-3 

Lecture des noms des colonnes 

II est egalement possible de recuperer des resultats dans un objet avec la methode 
fetchO, en utilisant la syntaxe suivante : 



object $result->fetch(PDO::FETCH_OBJ) 
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Par exemple, le code suivant permet d'afficher les resultats d'une requete SELECT : 

while($ligne=$result->fetch(PDO::FETCH_OBJ)) 
{ 

foreach($l igne as $donnee) 

{ 
echo $donnee; 

} 

echo "<br />"; 



Insertion de donnees dans la base 

Sur un site interactif, il faut pouvoir enregistrer dans la base de donnees les informations 
saisies par les visiteurs dans un formulaire XHTML, en vue d'une reutilisation ulterieure 
(par exemple, pour consulter ou reutiliser les coordonnees completes d'un client). 

Comme dans les chapitres 15 et 16, placez-vous dans la perspective d'un site de e- 
commerce. Vous allez ainsi envisager la realisation de la saisie puis de l'insertion des 
coordonnees d'un client dans la table cl 1 ent de la base magasin. Dans un second temps, 
vous lui permettrez de mettre a jour les informations enregistrees. 

Insertion des donnees 

Le formulaire XHTML est l'outil privilegie pour saisir des donnees et les envoyer vers le 
serveur PHP/MySQL. Nous disposons desormais de la fonction connexpdoO pour effec- 
tuer la connexion et des methodes exec( ) et query( ) pour l'envoi des requetes. Seule la 
commande SQL INSERT distingue cette operation de celle de lecture de donnees. Le script 
de l'exemple 17-7 realise ce type d'insertion en recuperant les donnees saisies par le 
client dans un formulaire lors d'une commande. Nous commencons par verifier l'exis- 
tence des saisies obligatoires correspondant aux variables $_P0ST['nom'], $_P0ST 
['adresse'] et $_P0ST[ 'ville'] (repere Q). Quand une requete est formee en utilisant les 
saisies faites par l'utilisateur, il est preferable d'utiliser le caractere d'echappement pour 
les caracteres speciaux des chaines recuperees dans le tableau $_P0ST, en particulier les 
guillemets, qui peuvent poser probleme dans la requete. Nous disposons pour cela de la 
methode quote ( ) des objets PDO dont la syntaxe est : 

string $idcom->quote(string $chaine) 

La chaine obtenue contient les caracteres d'echappement "/" devant les caracteres 
speciaux NULL, \n, \r, ', " et Control -Z. 

Le script recupere toutes les saisies et les protege (reperes © a ©). La colonne i d_cl i ent 
de la table client ayant ete declaree avec l'option AUTO_INCREMENT, il faut y inserer la 
valeur NULL en lui donnant la valeur "\N" (repere ©). L'envoi de la requete se faisant avec 
la methode execO, la valeur retournee est le nombre de lignes inserees (ici « 1 ») 
(repere Q), nous pouvons controler la bonne fin de l'insertion (repere ©). Le script doit 
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communiquer son identifiant au client pour qu'il puisse modifier eventuellement ses 
donnees. La valeur de la colonne id_client, qui a ete declaree AUTO_INCREMENT dans la 
table client, est recuperable a l'aide de la methode lastlnsertldO de l'objet PDO. Ce 
nombre entier est affiche dans une boite d'alerte JavaScript (repere ©). 

Exemple 17-7 Insertion de donnees 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<title>Saisissez vos coordonnees</title> 
</head> 
<body> 

<form action= "<?php echo $_SERVER[ ' PHP_SELF' ] ;?>" method="post" 
enctype="applicati on /x-www-form-url encoded "> 
<fieldset> 

<legend><b>Vos coordonnees</bX/legend> 
<table> 

<tr><td>Nom : </tdXtdXinput type="text" name="nom" size="40" maxlength="30"/> 
*</tdX/tr> 

<trXtd>Prenom : </tdXtdXinput type="text" name="prenom" size="40" 
*maxlength="30"/X/tdX/tr> 

<trXtd>Age : </td><td><input type="text" name="age" size="40" maxlength="2"/> 
*</tdX/tr> 

<trXtd>Adresse : </td><td><input type="text" name="adresse" size="40" 
*maxlength="60"/X/tdX/tr> 

<trXtd>Ville : </tdXtdXinput type="text" name="ville" size="40" maxlength="40"/> 
*</tdX/tr> 

<trXtd>Mail : </td><td><input type="text" name="mail" size="40" maxlength="50"/> 
*</tdX/tr> 
<tr> 

<td><input type="reset" value=" Effacer "></td> 
<td><input type=" submit" value=" Envoyer "></td> 
</tr> 
</table> 
</fieldset> 
</form> 
<?php 

incl udeC'connexpdo.inc.php") ; 
$idcom=connexpdo( 'magasin' , 'myparam' ) ; 

if(!empty($_POST['nom'])&& ! empty ($_P0ST[ 'adresse' ] )&& !empty($_POST[ 'vil le' ]) )<-© 
{ 

$id_client="\N"; <-© 

$nom=$idcom->quote($_POST[ 'nom' ] ) ; <— © 

$prenom=$idcom->quote($_POST['prenom'] ) ; <— Q 

$age=$idcom->quote($_POST['age']); <— 

$adresse=$idcom->quote($_POST[' adresse']) ; <— © 

$vi 1 1 e=$i dcom->quote( $_P0ST[ ' vi 1 1 e ' ] ) ; <— Q 
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$mail=$idcom->quote($_POST['mail ']); <— © 
//Requete SQL 

$requete="INSERT INTO client 

VALUES ($id_cl ient, $nom,$prenom,$age,$adresse,$vil lejmail )" ; 
*»//pas de guillemets si on applique la methode quote aux variables 
$nbl ignes=$idcom->exec($ requete) ; <— © 
if($nblignes!=l) <-© 



$mess_erreur=$idcom->errorInfo( ) ; 

echo "Insertion impossible, code", $idcom->errorCode( ) , 

echo "<script type=\"text/javascript\"> 

alertt ' Erreur : " .$idcom->errorCode( ) . " ' )</script>" ; 



echo "<script type=\"text/javascript\"> 
alertt 'Vous etes enregistre Votre numero de client est 
*$idcom->last Insert Id ( ) . " ' )</script>" ; <— Q 
$idcom=nul 1 : 



else {echo "<h3>Formulaire a completer!</h3>";} 

?> 

</body> 

</html> 



$mess_erreur[2] ; 



La figure 17-4 illustre la page de saisie et la figure 17-5 la boite d'alerte JavaScript qui 
donne son identifiant au client. 
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Boite d'alerte JavaScript dormant le nurnero de client 



Mise a jour d'une table 

Un client doit pouvoir modifier ses coordonnees, son adresse de livraison ou son adresse 
mail par exemple. L'exemple 17-8 cree une page contenant un formulaire qui permet la 
saisie du code client dans une zone de texte XHTML (repere 0*< L'attribut action de 
l'element <form> renvoie le traitement de la saisie au fichier mysqlpdoex9.php de l'exem- 
ple 17-9. La page creee est conforme a la figure 17-6. 

*~ Exemple 17-8 Page de saisies des modifications 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Modifiez vos coordonnees</title> 
</head> 
<body> 

<form action^ "mysqlpdoex9.php" method="post" enctype= 

^"application/x-www-form-url encoded "> 

<fieldset> 

<legend><b>Saisissez votre code client pour modifier vos coordonnees</bX/legend> 

<table><tbody> 

<tr> 

<td>Code client : </td> 

<td><input type="text" name="code" size="20" maxlength="10"/X/td><— O 

</tr> 

<tr> 

<td>Modifier : </td> 

<td><input type="submit" val ue="Modifier"/X/td> 

</tr> 

</tbodyX/table> 

</fieldset> 

</form> 
</body> 
</html> 

La mise a jour des coordonnees du client est realisee par le script de l'exemple 17-9. 
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, Modifrez vos coordortnees - Mozilla FirefoH 
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Page de saisie du code client 



La premiere inclusion de code PHP renvoie le client vers la page de saisie du code s'il a 
valide le formulaire sans avoir effectue de saisie (repere Q)- Rappelons, comme nous 
l'avons deja vu par ailleurs, que cette partie de code PHP doit figurer en tete du fichier 
car elle utilise la fonction header( ) pour effectuer la redirection. 

La suite du fichier comporte deux parties distinctes. La premiere cree dynamiquement un 
formulaire permettant la modification des donnees, quant a la seconde, elle enregistre ces 
memes donnees dans la base. 

Lors du premier appel du fichier de l'exemple 17-9, la condition de l'instruction if 
(repere©) est necessairement verifiee car la variable $_P0ST['modif' ] n'existe pas 
encore. Elle correspond a la valeur associee au bouton submit du formulaire qui n'est pas 
encore cree. Le script genere une connexion au serveur MySQL pour y lire les coordon- 
nees actuelles du client, dont le code est contenu dans la variable $code issue de la page 
de saisie de l'exemple 17-8 (repere ©). 

Dans le but de completer le formulaire avec les donnees actuelles, la requete SQL selec- 
tionne toutes les colonnes de la table client dont l'identifiant client (colonne 1 d_cl i ent de 
la table cl i ent) correspond a la valeur de la variable $code (repere 0). Cela permet de ne 
saisir que les modifications eventuelles de coordonnees du client, sans devoir ressaisir 
l'ensemble. Ces coordonnees sont lues a l'aide de la methode fetch( ) de l'objet $result 
de type PDOStatement. Elles sont alors contenues dans la variable $coord de type array. 
Pour afficher les coordonnees dans le formulaire, vous devez attribuer les valeurs de ces 
elements aux attributs val ue des differents champs <input /> (repere @). 

La figure 17-7 montre un exemple de creation dynamique de formulaire pour le client 
dont l'identifiant vaut 12. Le champ cache code du formulaire permet de passer la valeur 
du code client a la partie du script chargee de l'enregistrement des donnees modifiees 
(repere Q). 

L'envoi du formulaire utilise la deuxieme partie du script, qui met a jour les donnees du 
visiteur dans la table client apres avoir verifie l'existence de valeurs pour les champs 
obligatoires du formulaire (repere©). Seules les colonnes nom, adresse, ville et mail 
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peuvent etre mises a jour a l'aide de la requete suivante (repere Q). le reste etant force - 
ment inchange : 

I UPDATE client SET nom='$nom' ,adresse='$adresse' ,vil le='$vil le' , mail = ' $mai 1 ' 
WHERE id_client='$code' 

La verification du resultat de la requete (repere ©) permet d'afficher une boite d'alerte 
JavaScript contenant soit un message d'erreur, soit la confirmation de l'enregistrement. 
La page ne devant pas etre une impasse, le visiteur est redirige d' office vers la page 
d'accueil du site i ndex. html (reperes © et ©). 

Exemple 17-9 Mise a jour des donnees 

<?php 

if (empty($_POST['code' ] ) ) { header (" Location: my sqlpdoex8.php" ) ; ) <— © 
?> 
<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 
<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Modifiez vos coordonnees</title> 
</head> 
<body> 
<?php 

include( 'connexpdo.inc.php' ) ; 
$idcom=connexpdo( 'magasin' , 'my pa ram' ) ; 

if(!isset($_POST['modif ])) <-© 
{ 

$code=(integer)$_POST['code']; <— © 

//Requete SQL 

$requete="SELECT * FROM client WHERE id_cl ient='$code' " ; <— O 

$resul t=$idcom->query($ requete) 

$coord=$result->fetch(PDO::FETCH_NUM); <-© 

//Creation du formulaire complete avec les donnees existantes <— © 

echo "<form action= \"\ $_SERVER[ ' PHP_SELF' ] . "\" method^ 

b »\"post\"enctype=\"appl ication/x-www-form-urlencoded\">" ; 

echo "<fieldset>" ; 

echo "<legend><b>Modifiez vos coordonnees</bX/legend>" ; 

echo "<table>"; 

echo "<tr><td>Nom : </td><td><input type=\"text\" name=\"nom\" 

*size=\"40\" maxlength=\"30\" val ue=\"$coord[l]\"/> </tdX/tr>": 

echo "<trXtd>Prenom : </tdXtdXinput type=\"text\" name=\"prenom\" 

•»size=\"40\" maxlength=\"30\" val ue=\"$coord[2]\"/></td></tr>" : 

echo "<trXtd>Age : </tdXtdXinput type=\"text\" name=\"age\" 

•»size=\"40\" maxlength=\"2\" value=\"$coord[3]\"/X/tdX/tr>" ; 

echo "<tr><td>Adresse : </td><td><input type=\"text\" name=\"adresse\" 

*size=\"40\" maxlength=\"60\" value=\"$coord[4]\"/X/td></tr>": 
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echo "<tr><td>Ville : </td><td><input type=\"text\" name=\"ville\" 

*-size=\"40\" maxlength=\"40\" value=\"$coord[5]\"/X/tdX/tr>" ; 

echo "<trXtd>Mail : </td><td><input type=\"text\" name=\"inail \" 

*size=\"40\" maxlength=\"50\" value=\"$coord[6]\"/X/tdX/tr>" ; 

echo "<trXtdXinput type=\"reset\" value=\" Effacer \"></td> <td> 

*»<input type=\"submit\" name=\"modif\" val ue=\"Enregistrer\"X/tdX/trX/table>" ; 

echo "</fieldset>" ; 

echo Xinput type=\"hidden\" name=\"code\" value=\"$code\"/>" ; <— Q 

echo "</form>"; 

$resul t->closeCursor( ) ; 

$idcom=nul 1 ; 
} 

elseif(isset($_POST['nom'])&& isset($_POST[ 'adresse' ] )&& 
*isset($_POST['ville'])) <-© 
{ 

//ENREGISTREMENT 

$nom=$idcom->quoteC$_POST['nom']); 

$adresse=$idcom->quote($_POST[' adresse']) ; 

$ville=$idcom->quote($_POST['ville']); 

$mail=$idcom->quote($_POST['mail ']) ; 

$age=(integer)$_POST['age']; 

$code=(integer)$_POST['code'] ; 

//Requete SQL 

$requete="UPDATE client SET nom=$nom,adresse=$adresse,vil le=$ville,mail=$mail , 

*-age=$age WHERE id_cl ient=$code" ; <— Q 

$result=$idcom->exec($ requete) ; 



if($result!=l) <-© 
( 

echo "<script type=\"text/javascript\"> 

alertt ' Erreur : " .$idcom->errorCode( ) . " ' )</script>" ; <— (fy 



echo "<script type=\"text/javascript\"> alertt 'Vos modifications 

**sont enregis trees ' ) ;window.location='i ndex.html ' ;</script>" ; <— © 
} 

$idcom=nul 1 ; 



echo "Modifier vos coordonnees! " ; 
} 

?> 

</body> 
</html> 
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Figure 17-7 

Formulaire de saisie des coordonnees cree dynamiquement 



Recherche dans la base 

Un site de commerce en ligne doit permettre a ses visiteurs et futurs clients d'effectuer 
des recherches dans la base de donnees afin d'acceder plus rapidement a l'information 
correspondant au produit recherche. II doit en outre permettre d'effectuer des statistiques 
marketing a l'usage du proprietaire du site. Ces elements concernent aussi bien les sites 
de commerce en ligne que les annuaires et moteurs de recherche des sites de contenu. 

L'exemple 17-10 cree un formulaire classique permettant de saisir un mot-cle et de choi- 
sir le type de tri des resultats. Les criteres de tri selon le prix, la categorie ou l'identifiant 
d'article sont affiches sous forme de liste deroulante. Le choix de l'ordre croissant ou 
decroissant s'effectue au moyen de deux boutons radio possedant le meme attribut name, 
ce qui les rend exclusifs l'un de 1' autre. 

Le script controle d'abord que le visiteur a saisi un mot-cle dans le formulaire en veri- 
fiant que la variable $_POST['motcle'] n'est pas vide (repere Q)- II recupere ensuite le 
mot-cle, la categorie, le critere de tri et l'ordre d' affichage respectivement dans les varia- 
bles $motcle, $categorie, $ordre et $tri (reperes Q a 0). 

Si la categorie choisie est "tous", la partie de la commande WHERE concernant cette catego- 
rie est vide. Pour les autres choix, elle est egale a "AND categori e=$categori e" (repere ©). 
La requete de selection suivante (repere Q) est alors creee par le code : 

"SELECT id_article AS 'Code article', 

designation AS 'Description', 

prix, categorie AS 'Catégorie' 

FROM article WHERE lower(designation) LIKE'%$motcle%'" .Sreqcategorie. 

"ORDER BY $tri $ordre"; 
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On peut remarquer l'utilisation de la fonction MySQL 1 ower( ) qui permet d'effectuer une 
recherche insensible a la casse ; de cette facon, que l'utilisateur cherche les mots-cles 
« sony » ou « Sony », il obtiendra bien les resultats presents dans la table arti cl e. 

L'utilisation d'alias donne un meilleur affichage des titres du tableau de resultats. Apres 
la connexion au serveur, vous recuperez le resultat de la requete dans la variable $ result. 
La lecture des resultats et 1' affichage de toutes les lignes retournees sont realises avec la 
methode fetch ( ) de la meme maniere que dans les exemples precedents (repere ©). La 
figure 17-8 montre la page creee apres la recherche du mot-cle portabl e. 

Exemple 17-10. Page de recherche d'articles 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 

<title>Rechercher un article dans le magasin</title> 
</head> 
<body> 

<form action= "<?php echo $_SERVER['PHP_SELF']?>" method="post" 

*»enctype="appl icati on /x-www-form-url encoded "> 

<fieldset> 

<legend><b>Rechercher un article en magasin</b></legend> 

<table> 

<tbody> 

<tr> <td>Mot-clé: </td> 

<td><input type="text" name="motcle" size="40" maxlength="40" 

w-value="<?php $_POST['motcle']?>"/X/td> 

</tr> 

<tr> 

<td>Dans la catégorie : </td> 

<td> 

<select name="categorie"> 

<option value="tous">Tous</option> 

<option value="video">Video</option> 

<option valuer" informatique">Informatique</option> 

<option val ue= " photo ">Photo</option> 

<option value="divers">Divers</option> 

</select> 

</td> 

</tr> 

<tr> 

<td>Trier par : </td> 

<td> 

<select name="tri"> 

<option value="prix">Prix</option> 

<option value="categorie">Categorie</option> 

<option value="id_article">Code</option> 

</select> 
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</td> 
</tr> 

<tr><td>En ordre: </td> 

<td>Croissant<input type="radio" name="ordre" value="ASC" checked="checked"/> 

*»Décroissant<input type="radio" name="ordre" value="DESC" /> 

</td> </tr> 

<tr><td>Envoyer</tdXtd><input type="submit" name="" value="0K"/> </td> </tr> 

</tbody> 

</table> 

</fieldset> 

</form> 
<?php 

if(!empty($_POST['motcle'])) <— © 
{ 

include('connexpdo.inc.php') ; 

$motcl e-strtol ower( $_P0ST['motcl e'] ) ; <— © 

$ categories ($_P0ST[ 'categorie' ] ) ; <— © 

$ordre=($_POST['ordre']); <— © 

$tri=($_POST['tn"]); <-© 

//Requete SQL 

$reqcategorie=($_POST[ 'categorie' ]=="tous" )?"" : "AND categorie= 

^* '$categorie' " ; <— © 

$requete="SELECT id_article AS 'Code article' .designation AS 'Description' ,prix, 

*»categorie AS 'Categorie' FROM article WHERE lower(designation) 

*LIKE'«motcler ".Sreqcategorie. "ORDER BY $tri $ordre";<— © 

$idcom=connexpdo('magasin' , 'my pa ram') ; 

$resul t=$idcom->query($ requete) ; <— © 

if(!$result) <-© 

{ 

echo "Lecture impossible"; 
} 

else 
{ 

$nbcol=$result->col umnCount( ) ; 

$nbart=$result->rowCount( ) ; 

if($nbart==0) 

{ 
echo "<h3> II n'y a aucun article correspondant au mot-c1é : Smotcle 
*-</h3>"; 
exit; 

} 

$ligne=$result->fetch(PDO::FETCH_ASSOC); //tableau associatif 

$titres=array_keys($ligne) j 

$1 igne=array_values($l igne) ; 

//print_r($titres) ; 

echo "<h3> II y a Snbart articles correspondant au mot-clé : $motcle</h3>" 

//Affichage des titres du tableau 

echo "<table border=\"l\"> <tr>"; 
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foreach($titres as $val) 
{ 

echo "<th>", htmlentities($val) ,"</th>"; 
} 

echo "</tr>"; 

//Affichage des valeurs du tableau 
do 
{ 
echo "<tr>"; 

foreach($l igne as Sdonnees) 
{ 

echo "<td>", Sdonnees, "</td>"; 
} 

echo "</tr>"; 
} 

while($ligne=$result->fetch(PDO::FETCH_NUM)); 
} 

echo "</table>"; 
$resul t->closeCursor( ) ; 
$idcom=nul 1 ; 
} 

?> 

</body> 
</html> 
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Formulaire de recherche et resultats obtenus 
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Les requetes preparees 

Nous avions deja construit dynamiquement des requetes SQL dans l'exemple precedent 
a partir d' informations saisies par l'utilisateur. Les requetes preparees permettent de 
creer des requetes SQL qui ne sont pas directement utilisables mais qui contiennent des 
parametres auxquels on peut donner des valeurs differentes en fonction des besoins, par 
exemple, pour des appels repetitifs avec des valeurs differentes. Une requete preparee se 
presente, entre autres, sous la forme suivante : 

SELECT prenom.nom FROM client WHERE ville=? AND id_client>=? 

Dans laquelle les caracteres ? vont etre remplaces par des valeurs quelconques en fonc- 
tion des besoins du visiteur. C'est la methode que nous avons employee au chapitre 16. 

Ou encore avec des parametres nommes : 

SELECT prenom.nom FROM client WHERTE ville=:ville AND id_cl ient=:id_cl ient 

C'est d'ailleurs cette methode que nous allons utiliser ici. 

Les parametres nommes : vi 1 1 e et : i d_cl i ent, dont les noms sont ici les memes que ceux 
des attributs de la table cl ient, sont en fait arbitraires. 

La demarche a suivre pour utiliser une requete preparee est la suivante : 

1. Ecrire la chaine de requete comme parametre de la methode preparet ) de l'objet PDO. 
Cette methode retourne un objet de type PDOStatement qui represente la requete prepa- 
ree et qui est note Sreqprep dans notre exemple. 

2. Lier les parametres dans l'ordre de leur apparition avec des valeurs ou des variables. 
Cette liaison peut se faire de plusieurs manieres : 

- En creant un tableau associatif de la forme : 

$tab=array( ' :vi lie' =>$v1 lie. 'id_cl ient' =>$id_cl ient) 

les variables $vi 1 1 e et $i d_cl 1 ent ayant deja des valeurs a ce stade. Ce tableau sera 
ensuite passe en parametre a la methode execute ( ) detaillee ci-apres. 

- En appelant la methode bi ndParam( ) des objets PDOStatement pour chaque parametre 
selon le modele : 

bindParam(':ville',$ville,PDO::PARAM_STR) 

dans lequel le troisieme parametre designe le type de la variable et peut prendre les 
valeurs PDO: : PARAM^STR pour une chaine et PDO : : PARAM_I NT pour un entier. 

3. Executer la requete en appelant la methode execute( ) de l'objet PDOStatement avec le 
tableau comme parametre, s'il a ete cree a l'etape 2, ou sinon sans parametre. 

4. Pour les requetes preparees qui retournent des resultats, comme celles qui contien- 
nent la commande SELECT, il faut ensuite lier les resultats a des variables PHP, avec la 
methode bindCol umn( ) selon les modeles : 

$regprep->bindCol umnd ,$prenom) 
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ou encore : 

$regprep->bindCol umn(prenom,$prenom) 

Dans ce cas, la valeur de la colonne 1 designee dans la requete sera contenue dans la 
variable Sprenom, et ainsi de suite. 

5. Les lignes de resultats sont obtenues en appliquant une des methodes vues precedem- 
ment, comme fetchO ou fetchAlK), a l'objet PDOStatement representant la requete 
preparee, designee ici par $regprep. Une ou plusieurs boucles, selon les cas, permet 
d'afficher les resultats en utilisant les variables creees a l'etape 4. 

6. Liberer la memoire occupee par l'objet PDOStatement avec la methode close- 
Cursort ). 

L'exemple 17-11 presente une application de requete preparee dans laquelle ce sont les 
saisies d'un utilisateur qui determinent les valeurs des parametres et done la requete 
finale. Un formulaire classique demande la saisie d'un nom de ville et d'un numero de 
client (reperes Q et ©) dans le but de trouver tous les clients habitant cette ville et dont 
l'identifiant est superieur ou egal a la valeur saisie. Ces informations sont tout d'abord 
recuperees dans les variables $vi 1 1 e et $1 d_cl i ent (reperes Q et ©). Apres la connexion 
a la base, nous ecrivons la requete preparee avec la methode prepare( ) (repere 0). La 
liaison des parametres aux variables Sville et $id_client est effectuee en appelant la 
methode bindParam( ) avec les arguments qui precisent le type de variables (reperes © 
et Qi. La requete est ensuite executee avec la methode executeO sans parametre 
(repere ©). Les resultats des colonnes prenom et nom de la table client sont ensuite lies 
aux variables $prenom et $nom (reperes Q et ©). Une boucle while parcourt l'ensemble 
des resultats et permet l'affichage de toutes les lignes (repere ©). 

Notez que, comme nous le venons de le voir en exposant la methode generale, pour obtenir 
un resultat identique, les trois lignes de liaison des parametres pourraient etre remplacees 
par les lignes suivantes : 

I//*****Liaison des parametres 
$reqprep->execute(array( ' :vil le' => Sville, ' : i d_c! i ent ' -> $id_cl ient) ) ; 

Exemple 17-11 Utilisation des requetes preparees 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 
<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Recherche de cl ient</title> 
<style type="text/css" > 

div{font-size: 20px;} 
</style> 
</head> 
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<body> 

<form method="post" action="<?php echo $_SERVER['PHP_SELF'] ;?>"> 

<fieldset> 
<legend>Recherche de cl ient</legend> 

<label>Ville </label><input type="text" name="vil le" /Xbr /Xbr />^© 
<label>Id_cl ient</label><input type="text" name="id_cl ient" /Xbr /><— © 
<input type=" submit" value="Envoyer" /> 
</fieldset> 
</form> 
</body> 
</html> 



<?php 

if(isset($_POST['ville']) 

{ 



isset($_POST['id_client'])) 



$vi 1 1 e=strtol ower ( $_P0ST['vi lie']); <-© 

$i d_cl i ent=$_P0ST[ 'i d_cl i ent' ] ; <-© 

include('connexpdo.inc.php') ; 

$idcom=connexpdo('magasin' , 'my pa ram') ; 

$reqprep=$idcom->prepare("SELECT prenom.nom FROM client WHERE 

*»lower(vil le)= :ville AND id_client>= :id_client ");<—© 

//*****Liaison des parametres 

$reqprep->bindParam( ' :vil le' ,$vil le.PDO: :PARAM_STR); <— © 

$reqprep->bindParam( ' : id_cl ient ' ,$id_cl ient.PDO: :PARAM_INT); <— © 

$reqprep->execute( ) ; <— © 

//*****Liaison des resultats a des variables 

$reqprep->bindCol umn( 'prenom' , $prenom) ; <— © 

$reqprep->bindCol umn( 'nom' , $nom) ; <— © 

//*****Affichage 

echo "<divXh3>Il y a ", $reqprep->rowCount( ) ," client(s) habitant a ", 

**ucfirst($ville) , " et dont 1 Mdentifiant est superieur a $id_cl ient</h3Xhr />" 

while($result=$reqprep->fetch(PDO::FETCH_BOUND)) <-© 

{ 

echo "<h3> Sprenom $nom</h3>"; 
} 

echo "</div>"; 
$reqprep->closeCursor( ) ; 
$idcom=nul 1 ; 



) 
?> 



Avec notre base de donnees magasin et les parametres "Paris" et "3" nous obtenons par 
exemple l'affichage presente a la figure 17-9. 



PDO et MySQL 

Chapitre 1 7 



i Recherche ete client - Knozilla FUrefo* 



:_ J 



tichier Ldition .fittichage tlistonque Marque-pages tluttls £ 

S (^ _, http://l ocalhoEt/eha pl7/rriyEq(pdtJ exll . php 



•a 



,j- 



Recherche dc client 



Vflle Pans 



Idclient 3] 

i Envoyer | 



II v a 2 client(s) habitant a Paris et dont ridentifiant est 
superieur a 3 



Pierre Marti 
Jeanne Dare 






Temtifie 



Figure 17-9 

Resultats d'une requete preparee 



Les transactions 

Dans l'exemple de notre base magasin, si un client effectue un achat, il faut realiser 
simultanement deux insertions, une dans la table commande et une dans la table ligne. Si 
pour une raison quelconque, materielle ou logicielle, la seconde insertion n'est pas reali- 
see, alors que la premiere Test deja, la base contiendra une incoherence car il existera une 
commande ne comportant aucune ligne. L' inverse ne serait guere preferable puisqu'il 
existerait une ligne qui ne serait reliee a aucune commande. Les transactions permettent 
de gerer ce genre de situation en effectuant des commandes « tout ou rien » ce qui, en 
pratique pour notre exemple ci-dessus, permet d'executer les deux requetes ou bien aucune 
si l'une des deux insertion n'a pas ete effectuee. L'integrite de la base est ainsi preservee. 

Le langage SQL possede des commandes qui permettent de gerer les transactions, mais 
PDO nous fournit des methodes qui permettent de gerer les transactions sans y faire appel. 

Une transaction doit commencer par l'appel de la methode begi nTransacti on( ) de l'objet 
PDO qui desactive le mode autocommit qui est automatiquement active par defaut dans 
MySQL. L' envoi des requetes au serveur se fait comme d' habitude avec les methodes 
query( ) ou exec( ), selon qu'elles retournent des resultats ou pas. Ce n'est qu'apres avoir 
verifie que les differentes requetes ont ete correctement effectuees que nous pouvons 
valider l'ensemble en appelant la methode commi t ( ) . Dans le cas contraire, par exemple si 
l'une d'entre elles n'a pas ete realisee, nous annulons l'ensemble en appelant la methode 
rollBackO. 
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Dans l'exemple 17-12, nous illustrons la procedure a suivre pour effectuer deux 
commandes INSERT sur la table article (reperes © et ©)• Nous envoyons ensuite ces 
requetes au serveur avec la methode exec( ) qui retourne le nombre de lignes affectees par 
chaque requete. La variable $verif cumule done le nombre total d'insertions (reperes © 
et ©). Si ce nombre vaut 2 (repere ©), nous pouvons valider la transaction avec la methode 
commitO (repere©), sinon elle est annulee avec la methode rollBackO (repere©), un 
message d'erreur est affiche (reperes © et ©) et le tableau indice retourne par la methode 
errorInfo( ) contenant le code d'erreur pour l'indice et le message d'erreur en clair pour 
l'indice 2. Pour tester l'efficacite du script, il suffit d'introduire une erreur dans la 
seconde requete en ecrivant, par exemple, le nom de table inexistant "cl i ents" a la place 
de "cl ient", pour constater avec phpMy Admin qu'aucune insertion n'est effectuee alors 
que la premiere est valable. 

Exemple 17-12 Insertions avec transaction 

<?php 

incl ude( 'connexpdo.inc.php' ) ; 

$idcom=connexpdo('inagasin' , 'my pa ram') ; 

$idcom->beginTransaction( ) ; 

echo "<hr />"; 

$requetel=" INSERT INTO client(id_cl ient,nom,prenom,age,adresse,vil le.mail ) 

** VALUES (NULL , 'Spencer', 'Marc', '32', 'rue du blues', 'Orleans', 

** 'marc@spencer.be' );" ; <— © 

echo Srequetel, "<hr />"; 

$requete2=" INSERT INTO client(id_cl ient,nom,prenom,age,adresse,vil le.mail ) 

LVALUES (NULL , 'Spancer', 'Diss', '89', 'rue du Metad', 'New York', 

*• 'diss@metad.fr');"; <— © 

echo $requete2, "<hr />"; 

//Insertions des donnees 

$verif= $idcom->exec($requetel) ; <— © 

$verif+= $idcom->exec($requete2) ; <— © 

if($verif==2 ) <-© 

{ 

$idcom->commit( ) ; <— © 

echo "Insertions reussies de $verif lignes<br />"; 
} 

else 
{ 

$idcom->rollBack(); <— © 

$tab_erreur=$idcom->errorInfo( ) ; 

echo "Insertions annulees. Erreur n' : " ,$tab_erreur[0] , "<br />";<—© 

echo "Info : " ,$tab_erreur[2] ; <— © 
} 
?> 
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Memo des methodes 
Classe PDO 

boolean beginTransaction ( void ) 

Commence une transaction et retourne TRUE en cas de reussite ou FALSE sinon. 

boolean commit ( void ) 

Valide une transaction. 

objetPDO construct ( string $dsn [, string $username [, string Spassword ]] ) 

Constructed de la classe PDO. Cree un objet representant la connexion. 

string errorCode ( void ) 

Retourne un code d'erreur. 

array errorlnfo ( void ) 

Retourne un tableau contenant un code d'erreur (indice 0) et un message d'erreur (indice 2). 

integer exec ( string $requete ) 

Execute une requete qui ne retourne pas de resultat et retourne le nombre de lignes affectees. 

string lastlnsertld ( ) 

Retourne I'identifiant de la colonne dont I'attribut est declare AUTO_INCREMENT. 

objet PDOStatement prepare ( string $requete ) 

Cree une requete preparee et retourne un objet PDOStatement. 

objet PDOStatement query ( string $requete ) 

Envoie une requete au serveur et retourne un objet resultat. 

string quotet string Schaine ) 

Protege les caracteres speciaux d'une chaine. 

boolean rollBack ( void ) 

Annule la transaction courante. 

Classe PDOStatement 

boolean bindColumn ( divers $colonne, divers $var [, integer type] ) 

Lie une colonne designee par son numero ou son nom a une variable ; le type peut etre PDO: :PARAM_STR pour une 
chaine ou PDO: :PARAM_INT pour un nombre. 

boolean bindParam (divers $parametre, divers Svariable [, int type ] ) 

Lie un parametre nomme ou interrogatif a une variable. La constante type prend les memes valeurs que ci-dessus. 

integer columnCount ( void ) 

Retourne le nombre de lignes d'un resultat. 

string errorCode ( void ) 

Retourne un code d'erreur. 
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array errorlnfo ( void ) 

Retourne un tableau contenant les informations sur I'erreur en cours. 

bool execute ( [array Sparametre] ) 

Execute une requete preparee ; le parametre peut contenir les liaisons des parametres nommes ou interrogatifs. 

divers fetch ( [integer $style] ) 

Retourne une ligne de resultat sous forme de tableau indice ou associatif. 

array fetchAll ( [integer $style ) 

Retourne I'ensemble des lignes de resultat sous forme de tableau multidimensionnel indice ou associatif. 

int rowCount ( void ) 

Retourne le nombre de lignes affectees par la derniere requete. 



Classe PDOException 



objet PDOException _construct() 

Cree un objet exception. 

string getCodeO 

Retourne le code d'erreur. 

string getFileO 

Retourne le nom du fichier dans lequel s'est produite I'erreur. 

integer getLinet) 

Retourne le numero de ligne du script ou s'est produite I'erreur. 

string getMessage( ) 

Retourne le message d'erreur. 



Exercices 



Tous les exercices ci-dessous portent sur la base de donnees voitures creee aux chapi- 
tres 13 et 14. lis sont identiques a ceux du chapitre 15 et 16 mais vous devez les realiser 
uniquement avec PDO. 

Exercice 1 

Creez un script permettant d'afficher le contenu de la table model e dans un tableau 
XHTML. Les resultats doivent etre tries par marque. 

Exercice 2 

Creez un formulaire permettant l'insertion de nouvelles donnees dans la table model e. 
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Exercice 3 

Creez un formulaire permettant l'insertion simultanee des coordonnees d'une personne 
dans les tables proprietaire et cartegrise. II doit contenir les zones de saisie des coor- 
donnees de la personne et la liste des modeles d'une marque creee dynamiquement a 
partir de la saisie de la marque. 

Exercice 4 

Creez un formulaire de recherche permettant de retrouver tous les proprietaries d'un type 
de vehicule de marque et de modele donnes. Affichez les resultats sous forme de tableau 
XHTML. 

Exercice 5 

Creez un formulaire de recherche permettant de retrouver tous les vehicules possedes par 
une personne donnee. Affichez les resultats sous forme de tableau XHTML. 

Exercice 6 

Reecrivez entierement le code de l'exercice 5 en recuperant tous les resultats dans des 
objets et en manipulant leurs proprietes. 

Exercice 7 

Refaire l'exercice 4 en utilisant une requete preparee. 

Exercice 8 

Refaire l'exercice 3 en utilisant une transaction pour s'assurer que les donnees sont bien 
inserees dans les differentes tables. 
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La base SQLite 



SQLite constitue l'une des grandes nouveautes de PHP 5. II s'agit d'une base de donnees 
relativement puissante mais qui, a la difference de MySQL ou de PostgreSQL, ne neces- 
site pas 1' installation d'un serveur de base de donnees en plus d'un serveur PHP car elle 
est incorporee a PHP comme Test le module standard. 

D'apres ses concepteurs et les tests realises, SQLite se revele beaucoup plus rapide que 
MySQL et PostgreSQL pour les operations de lecture. Les operations d'ecriture perdent 
un peu de cet avantage car dans ce cas la base est verrouillee dans son integralite, meme 
si l'operation ne concerne qu'une table. 

Dans l'etat actuel de son developpement, SQLite n'est interessant que pour les applica- 
tions qui ne necessitent pas un grand nombre d'acces concurrents en ecriture a la base. II 
y a peu de chance, par exemple, qu'un site comme Google l'adopte, mais elle pourrait 
suffire a des entreprises de taille moyenne et pour des applications installees sur des 
terminaux mobiles. 



Caracteristiques generates 

Contrairement a de nombreux autres SGBD, comme MySQL, SQLite cree la base direc- 
tement sur le disque dur de votre serveur. A chaque base correspond done un seul fichier, 
quel que soit le nombre de tables qu'elle contient. Dans ce fichier sont a la fois enregis- 
trees la structure des tables et les donnees (voir figure 18-1). Comme vous le voyez, ce 
fichier est inutilisable tel quel. Pour cette raison, la modification de la structure d'une 
table est impossible en utilisant la commande ALTER TABLE. Vous devez d'abord sauvegar- 
der les donnees, effacer la table puis la recreer avec une nouvelle structure. 
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sportifs - Bloc-notes 



Fichier Edition Format AfTichage ? 



** This file contains an SQLite 2.1 database ** (uaUD 
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Figure 18-1 

Structure d'un fichier de base SQLite 



SQLite supporte l'essentiel des fonctionnalites du langage SQL, a l'exception des 
suivantes : 

FOREIGN KEY ; 

Support complet de ALTER TABLE ; 

support integral des triggers ; 

transactions imbriquees ; 

COUNT (DISTINCT X) ; 

V I EW en ecriture ; 

GRANT et REVOKE (pas de gestion des droits d'acces). 

D'apres les tests publies sur le site SQLite (http://www.sqlite.org), cette base est jusqu'a trois 
fois plus rapide que MySQL dans les acces en lecture de donnees. En revanche, le fait 
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que toute la base soit contenue dans un seul fichier entraine son verrouillage total lors des 
acces en ecriture. Cela ralentit les operations dans le cas d'acces concourants a la base. 

Dans sa version actuelle 2.8, SQLite est dite « typeless », c'est-a-dire qu'elle n'oblige 
pas a effectuer une declaration du type de chaque colonne lors de la creation des tables, 
contrairement a MySQL. Vous pouvez cependant conserver vos habitudes pour l'ecriture 
des requetes SQL de creation des tables en definissant un type pour chaque colonne. 

Lors des operations de comparaison et de tri, SQLite etablit une difference entre les 
valeurs numeriques et les textes. Les colonnes declarees avec un type contenant les mots 
CHAR, TEXT ou BLOB sont considerees comme du texte. Toutes les autres possibilites, y 
compris les types personnels non normalises par le SQL, sont considerees comme nume- 
riques. 

Dans le code suivant : 

CREATE TABLE matable(nom LETEXTE, age SONAGE) 

La colonne nom est consideree comme du texte et la colonne age comme un nombre en 
32 bits. 

Ce typage des donnees etant peu rigoureux pour une base de donnees, la version 3.0 de 
SQLite prevoit de reconnaitre explicitement les types suivants : NULL, INTEGER, REAL, TEXT 
et BLOB, ce qui la rapprochera des pratiques habituelles. Dans la suite du chapitre, vous 
creerez les tables de votre base en declarant le type des colonnes. 

De nombreuses tables comportent une cle primaire, qui est un entier auto-incremente 
d'une unite a chaque nouvelle insertion. SQLite ne reconnait pas l'attribut AUTO_INCREMENT 
utilise avec MySQL pour creer ce type de colonne. Pour obtenir le meme resultat, il faut 
declarer la colonne avec le type INTEGER PRIMARY KEY, comme ci-dessous : 

CREATE TABLE personneO'd INTEGER PRIMARY KEY, nom VARCHAR(20) ); 

L'insertion de la valeur NULL dans la colonne id permet cette incrementation automa- 
tique. 

Linterface SQLiteManager 

Comme pour MySQL avec phpMyAdmin, des programmeurs benevoles ont cree des 
interfaces de gestion en ligne des bases de donnees SQLite. II en existe plusieurs, comme 
phpSQLite Admin et SQLiteManager. Cette derniere version est livree d'office avec 
Wampserver. 

Si votre hebergeur n'offre pas cette interface, vous pouvez 1' installer vous meme 
puisqu'il s'agit de fielders PHP (voir le site http://www.sqlitemanager.org). La figure 18-2 
montre la page d'accueil de SQLiteManager 1.2, a partir de laquelle vous pouvez creer 
une base et les tables qui la composent. L'application sur laquelle reposent les exemples 
de ce chapitre a pour but de creer un site de contact entre sportifs partageant la meme 
passion et leur permettant de trouver des partenaires eventuels. Ce modele pourrait etre 
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facilement transpose a d'autres applications pratiques. Vous aurez a developper entiere- 
ment cette application au chapitre 21. 
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Figure 18-2 

La page d'accueil de SQLiteManager 

Le modele conceptuel de donnees (MCD) de la base nommee sportifs est illustre a la 
figure 18-3. II comporte les contraintes suivantes : 

• L'entite personne regroupe les donnees personnelles d'un visiteur inscrit. 

• L'entite sport contient les caracteristiques de chaque sport. 

• L'association pratique relie ces deux entites. 

• Une personne pratique un ou plusieurs sports. La cardinality du cote de l'entite 
personne est done 1:N. 

• Un sport est pratique par une ou plusieurs personnes. La cardinality du cote de l'entite 
sport est done 1:N. 
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Figure 18-3 

Le MCD de la base sportifs 
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Le modele logique de donnees (MLD) correspondant, en application des regies vues au 
chapitre 13, est represente a la figure 18-4. Chaque personne peut pratiquer de 1 aiV 
sports, et un sport peut etre pratique par I aN personnes. 
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Figure 18-4 

Le MLD de la base sportifs 

La base sporti f s comprend done les trois tables suivantes : 

• La table personne, qui contient les coordonnees de chaque personne inscrite sur le site 
(nom, prenom, departement, adresse e-mail). L'identifiant auto-incremente id_personne 
est la cle primaire de la table. 

• La table sport, qui contient le nom de chaque sport pratique contenu dans l'attribut 
design. Elle sera enrichie par les visiteurs du site en fonction de leurs besoins. Chaque 
sport a un identifiant unique auto-incremente id_sport, qui est la cle primaire de la 
table. 

• La table pratique est la representation de 1' association entre les tables personne et 
sport. Sa cle primaire est constituee des cles primaires des tables personne et sport. On 
obtient ainsi l'association entre une personne et un sport. L'attribut niveau contient le 
niveau de pratique de chaque utilisateur pour un sport donne. 

Pour creer les tables, vous utilisez SQLiteManager. Pour cela, dans la page d'accueil de 
Wampserver (http://1 27.0.0.1 ou http://localhosf) ou dans le menu de Wamp2, cliquez sur 
SQLiteManager afin d'obtenir la page represente a la figure 18-2. 

Pour que les bases soient manipulables avec SQLiteManager, il faut qu'elles soient 
creees dans le repertoire C:/wamp/apps/sqlitemanagerl.2.0/. Completez les zones de 
saisies conformement a la figure 18-2, puis cliquez sur Enregistrer. Un fichier nomme 
sportifs est alors cree sur le serveur. La creation des tables se deroule ensuite selon la 
meme demarche qu'avec phpMy Admin. II faut d'abord saisir le nom de la table et son 
nombre de colonnes, puis une nouvelle page permet la definition des caracteristiques de 
chaque colonne. 



Methodes d'acces a SQLite 

L'acces a une base SQLite peut etre fait de deux manieres differentes : 

• La methode procedurale classique, qui emploie des fonctions PHP, comme nous 
l'avons realise avec MySQL. Pour un role identique, les noms des fonctions sont 
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souvent similaires a ceux de l'extension MySQL. Par exemple, au lieu d' avoir la fonc- 
tion mysql_query( ) on aura la fonction sql ite__query( ). 

• La methode objet, qui emploie quatre types d'objets differents ayant chacun des 
proprietes et des methodes qui permettent l'acces aux donnees. Cette methode se situe 
davantage dans l'esprit de PHP 5, plus oriente objet que les versions precedentes. 

Vous allez realiser de memes exemples selon ces deux methodes. 

La methode procedural 

Quelles que soient les operations que Ton desire realiser sur la base SQLite, la methode 
procedurale est presque semblable a celle utilisee pour MySQL. Elle consiste a suivre les 
etapes suivantes : 

1. Ouverture de la base, qui s'apparente plutot a une ouverture de fichier. 

2. Envoi des requetes SQL a effectuer sur la base. 

3. Recuperation de la valeur de retour de la fonction de requete, qui est soit une valeur 
booleenne pour controler que la requete est bien executee — par exemple, CREATE 
TABLE, INSERT, UPDATE — , soit une valeur de type resource quand la requete SQL 
retourne des donnees — par exemple, SELECT. 

4. Utilisation le cas echeant des fonctions specialisees de recuperation des resultats, et 
creation d'un affichage dynamique approprie avec PHP et XHTML. 

5. Fermeture de la base. 

Ouverture de la base 

Pour ouvrir une base SQLite, vous utilisez la fonction sql ite_open( ), dont la syntaxe est 
la suivante : 

resource sqlite_open (string nom_base [, integer mode [, string Serreur]]) 

Si la base n'existe pas, elle est creee. Vous devez indiquer obligatoirement le nom de la 
base comme premier parametre. Celui-ci peut contenir le chemin d'acces complet au 
fichier ou une URL. Le parametre mode est un nombre en octal, qui indique le mode 
d'ouverture du fichier (lecture ou ecriture ou les deux, ainsi que les droits d'acces). Dans 
la version actuelle il n'est pas pris en consideration, et sa valeur par defaut est 0666. 

La chaine $erreur contient le nom de la variable qui sera affectee par reference avec le 
message d'erreur genere si l'ouverture de la base echoue. Vous pouvez done afficher ce 
message le cas echeant. Dans ce cas, la fonction retourne la valeur FALSE, ce qui permet 
de controler le bon deroulement de l'operation. Si tout se passe correctement, la fonction 
retourne une variable de type resource, qui est un identifiant d'ouverture que nous recu- 
perons dans la variable $id_base et qui est utilise dans de nombreuses autres fonctions de 
la meme maniere qu'avec MySQL. 
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Nous aurons, par exemple, le code d'ouverture suivant : 

<?php 

if ($id_base = sqlite_open ("ma_base", 0666, $erreur)) echo "OK" ; 

else echo $erreur ; 

?> 

Si le premier parametre est la chaine " : memory : ", la base est creee dans la memoire vive 
du serveur. Cette possibilite permet d'effectuer des traitements provisoires. La base creee 
est effacee a la fin du script. 

II est egalement possible de realiser une connexion persistante a l'aide de la variante 
sql ite_popen( ), dont la syntaxe est similaire : 

resource sqlite_open (string nom_base [, integer mode [, string $erreur]]) 

Pour fermer la base, vous devez appeler la fonction sql ite_cl ose( ), dont la syntaxe est la 
suivante : 

void sql ite_close(resource $id_base) 

et dont le seul parametre est ridentifiant d'ouverture de la base $i d_base. L'appel de cette 
fonction doit etre fait le plus vite possible dans le script afin de liberer le fichier contenant 
la base qui est verrouillee en ecriture a chaque acces. 



Envoi de requetes 



L'etape suivante consiste principalement dans l'envoi a la base de requetes ecrites a 
l'aide du langage SQL. Les connaissances acquises au chapitre 14 vont vous permettre 
d'etre tout de suite operationnel. Vous n'utiliserez que certaines possibilites supplemen- 
taires qu'offre SQLite par rapport a MySQL. 

Pour envoyer une requete a la base, vous utiliserez le plus souvent la fonction sqlite_ 
query( ), dont la syntaxe est la suivante : 

resource sqlite_query (resource $id_base, string Srequete) 

La variable $id_base est l'identifiant d'ouverture de la base et $requete la chaine conte- 
nant la ou les commandes SQL appropriees. 

Cette fonction retourne une variable de type resource si la requete SQL retourne des 
lignes de donnees, cette variable etant utilisable pour lire l'ensemble des donnees a l'aide 
de fonctions specialisees, comme c'est le cas pour MySQL. Si la requete ne concerne pas 
une commande SQL fournissant des donnees, la fonction retourne une valeur booleenne 
TRUE si l'operation est reussie et FALSE dans le cas contraire. De plus, si la requete n'est 
pas executee, la fonction retourne encore FALSE, ce qui permet de verifier sa bonne execu- 
tion a l'aide d'une instruction i f . 

Un script d' interrogation de la base a une structure identique a celle de l'exemple 18-1. 
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Exemple 18-1. Envoi de requete SQL 

<?php 

if ($id_base = sqlite_open ( "C:/wamp/apps/sql itemanagerl .2.0/sportifs" , 0666, 

*-$erreur) ) 

{ 

Srequete = "SELECT * FROM personne" ; 

if ($result = sqlite_query ($id_base, Srequete)) 

{ 
echo "Requete effectuee <br />" ; 
//Lecture des resultats 

} 

else echo " La requete n'a pas aboutie" ; 
} 

else echo $erreur ; 
?> 

Pour que le resultat ne soit pas mis en buffer sur le serveur avant son utilisation par les 
fonctions de lecture, vous pouvez utiliser la fonction sql ite_unbuffered_query( ), dont la 
syntaxe est la suivante : 

resource sql ite_unbuffered_query(resource $id_base, string $requete) 

Elle utilise les memes parametres que la precedente. Si elle mobilise moins de memoire 
sur le serveur, elle presente cependant 1' inconvenient d'obliger a utiliser les donnees du 
resultat avant tout autre envoi de requete, faute de quoi les resultats sont perdus. 

Pour envoy er une requete qui ne retourne pas de resultats, par exemple, une requete de 
creation de table, d' insertion ou de mise a jour, il peut etre plus efficace d' utiliser la fonc- 
tion sql ite_exec( ), dont la syntaxe est la suivante : 

boolean sql ite_exec(resource $id_base, string Srequete) 

Elle execute la requete Srequete sur la base identifiee par $id_base et retourne TRUE si la 
requete est bien realisee et FALSE dans le cas contraire. L'interface SQLiteManager 
n'etant pas encore exempte de bogues, il peut etre plus securisant de creer les tables de la 
base sportifs a l'aide d'un script a n'executer qu'une seule fois afin d'eviter tout risque 
d'erreur, car la clause IF NOT EXISTS de MySQL n'existe pas dans SQLite. L'exemple 18- 
2 cree les tables de la base sporti f s en envoyant les requetes SQL a la base avec la fonc- 
tion sql ite_exec( ) (reperes O et ©)• 

Exemple 18-2. Creation de table a l'aide d'un script 

<?php 

if ($id_base = sql ite_open( 'C:/wamp2/apps/sql itemanagerl .2. 0/sportifstest' , 0666, 
^»$erreur) ) 
{ 
echo "La base sportifs est ouverte"; 

//Creation de la table personne 
$req_personne="CREATE TABLE personne ( 
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id_personne INTEGER PRIMARY KEY , 

nom VARCHAR( 20 ) NOT NULL , 

prenom VARCHARt 20 ) , 

depart INTEGERt 2) NOT NULL, 

mail VARCHARC50) NOT NULL)"; 

if( sql ite_exec($id_base,$req_personne) ) echo "La table personne 

*»est creee" ; <— © 

//••it*********************************** 

//creation de la table sport 

$req_sport="CREATE TABLE sport ( 

id_sport INTEGER PRIMARY KEY , 

design VARCHARt 30 ) UNIQUE NOT NULL)"; 

//CREATE UNIQUE INDEX sport_design ON sport(design) ; 

if (sql ite_exec($id_base,$req_sport) )echo "La table sport est creee"; <— © 

//•it*************************** 

//creation de la table pratique 

$req_pratique="CREATE TABLE pratique ( 

id_personne INTEGER NOT NULL, 

id_sport INTEGER NOT NULL , 

niveau TINYINT, 

PRIMARY KEY (id_personne,id_sport) ) ; 

CREATE INDEX cle ON pratique(id_personne,id_sport) ; " ; 

if( sql ite_exec($id_base,$req_pratique) ) echo "La table pratique 

*»est creee" ; <— © 

sql ite_close($id_base) ; 



else 



echo "ERREUR : $erreur"; 



) 
?> 



Gestion des erreurs 

Les fonctions suivantes : 

int sqlite_last_error ( resource $id_base) 
string sql ite_error_string C int code_erreur) 

retournent respectivement le code et le message de I'erreur qui a ete generee. 



Contrairement a MySQL, SQLite accepte les requetes multiples. II est done possible de 
simplifier le code de l'exemple 18-2 en ecrivant les differentes commandes SQL de crea- 
tion des trois tables dans une seule chaine et en les separant par des points-virgules, 
comme dans l'exemple 18-3. Apres l'ecriture de la requete multiple par concatenation de 
commandes SQL dans la chaine $req_tabl es (reperes ©, © et ©), l'envoi de celle-ci est 
realise par la fonction sql ite_exec( ) (repere ©). 
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Exemple 18-3. Les requetes multiples 

<?php 

if ($id_base = sqlite_open ( "C:/wamp2/apps/sql itemanagerl.2.0/sportifs" , 0666, 

*»$erreur) ) 

{ 

echo "La base sportifs est ouverte"; 

//Requete de creation des tables 

$req_tables="CREATE TABLE personne ( 

id_personne INTEGER PRIMARY KEY , 

nom VARCHAR( 20 ) NOT NULL , 

prenom VARCHAR( 20 ) , 

depart INTEGERC 2) NOT NULL, 

mail VARCHARC50) NOT NULL);";*-© 

$req_tables.="CREATE TABLE sport ( 

id_sport INTEGER PRIMARY KEY , 

design VARCHAR( 30 ) UNIQUE NOT NULL); 

CREATE UNIQUE INDEX sport_design ON sport(design) ; " ; <—Q 

$req_tables.="CREATE TABLE pratique ( 
id_personne INTEGER NOT NULL, 
id_sport INTEGER NOT NULL , 
niveau TINYINT, 

PRIMARY KEY (id_personne,id_sport) ) ; 
CREATE INDEX cle ON pratique(id_personne,id_sport) ;" ; <— © 

i f C sql i te_exec( $i d_base , $req_tabl es ) ) <— © 

{ 
echo "Les tables sont creees"; 

} 
} 

else echo "ERREUR : $erreur"; 
?> 

L'inconvenient de cette methode est que si une erreur survient dans la creation de la 
deuxieme ou de la troisieme table (incident sur le serveur ou plus simplement erreur dans 
l'ecriture d'une seule commande SQL), le script s'arrete, mais la premiere table a quand 
meme ete creee. Pour eviter ce genre de probleme, vous avez interet a utiliser le meca- 
nisme des transactions pour envoyer des requetes multiples, comme vous le verrez dans 
la suite de ce chapitre. 



Cles composites 

Avec SQLite, il n'est pas possible de creer des cles etrangeres ou des cles primaires composites, comme 
il faudrait le faire dans la table pratique. Pour compenser, nous creons un index sur les attributs id_ 
personne et id„sport. Ceci empechera d'inserer plusieurs fois le meme sport pour la meme personne 
dans la table. 
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Insertion de donnees 



L'insertion de donnees a deja ete abordee au chapitre 15. Elle ne presente pas de difficul- 
tes particulieres dans SQLite. Vous pouvez done utiliser de la meme facon la commande 
SQL INSERT pour proceder a une insertion. Les donnees inserees dans la base proviennent 
des saisies effectuees par les visiteurs lors de leur inscription sur le site. Vous retrouvez 
ici le code de creation d'un formulaire qui vous est familier. La recuperation des valeurs 
cote serveur s'effectue egalement a l'aide de la variable $_P0ST, qui est un tableau super- 
global accessible dans tous les scripts. 

Dans les tables dans lesquelles il existe une cle primaire auto-incrementee, il est possible, 
apres l'envoi de la requete d'insertion, de recuperer la valeur de la cle en utilisant la fonc- 
tion sql 1te_l ast_insert_rowid( ), dont la syntaxe est la suivante : 

integer sqlite_last_insert_rowid($id_base) 

Les chaines saisies dans le formulaire peuvent contenir des caracteres speciaux suscepti- 
bles de poser probleme lors de leur incorporation aux chaines de requete SQL. Pour 
proteger ces caracteres, il faut appeler la fonction sqlite__escape_string(), selon la 
syntaxe la suivante : 

string sql ite_escape_string(string $chaine) 

Elle retourne une chaine dans laquelle les caracteres speciaux sont precedes du caractere 
d'echappement antislash (\). 

L'exemple 18-4 realise l'insertion des coordonnees d'un visiteur saisies dans un formu- 
laire identique a celui utilise pour la meme fonction a l'exemple 15-7. La gestion des 
donnees saisies est attribuee au script lui-meme dans l'attribut action de l'element <form> 
(repere Q)- Le visiteur doit saisir son nom, son prenom, son departement et son adresse 
e-mail dans des zones de texte nominees respectivement nom, prenom, depart et mail. Le 
script recupere les valeurs saisies dans les variables $nom, $prenom, $depart et $mai 1 a partir 
des variables $_P0ST['nom'], $_P0ST[ 'prenom'], $_P0ST[ 'depart'] et $_P0ST['ma1l '] (repe- 
res © a ©). 

Cette creation de nouvelles variables n'a pour objet que d'ameliorer la lisibilite du code, 
en particulier celle de la requete SQL d'insertion (repere©) envoyee par la fonction 
sql ite_exec( ) (repere Q) Si la requete n'est pas executee, vous affichez le code d'erreur 
retourne par la fonction sqlite_last_error() (repere©). Dans le cas contraire, vous 
informez le visiteur que l'enregistrement est realise en lui communiquant son numero 
d'enregistrement retourne par la fonction sqlite_last_insert_rowid() et en affichant 
une boite d'alerte JavaScript (repere ©). Dans tous les cas, la base est ensuite fermee 
(repere ©). 

Exemple 18-4. Insertion de donnees 

<!D0CTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" 

"http://www.w3.org/TR/REC-html40/strict.dtd"> 

<html> 

<head> 

<title>Saisissez vos coordonnees</title> 
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<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

</head> 

<body> 

<form action^ "<?php echo $_SERVER[' PHP_SELF' ] ;?>" method="post" 

enctype="applicati on /x-www-form-url encoded "> <— O 

<fieldset> 

<legend><b>Vos coordonnees</bX/legend> 

<table> 

<tr><td>Nom : </tdXtdXinput type="text" name="nom" size="40" maxlength="30"/> 

*</tdX/tr> 

<trXtd>Prenom : </tdXtdXinput type="text" name="prenom" size="40" 

*maxlength="30"/X/tdX/tr> 

<trXtd>Departement : </td><td><input type="text" name="depart" size="40" 

*maxlength="2"/X/tdX/tr> 

<trXtd>Mail : </td><td><input type="text" name="mail " size="40" maxlength="50"/> 

*</tdX/tr> 

<tr> 

<td><input type="reset" value=" Effacer "></td> 

<td><input type="submit" value=" Envoyer "></td> 

</tr> 

</table> 

</fieldset> 

</form> 

<?php 

if(!empty($_POST['nom'])&& !empty($_POST[ 'depart ' ]) && !empty($_POST[ 'mail' ] ) ) 

{ 

$nom= sql ite_escape_string($_POST[ 'nom' ]) ; <— © 

$prenom= sql ite_escape_string($_POST['prenom' ] ) ; <— © 

$depart= sql ite_escape_string($_POST[ 'depart' ]) ; <— © 

$mail= sql ite_escape_string($_POST[ 'mail ' ] ) ; <— © 

//Requete SQL 

$requete="INSERT INTO personne VALUES(NULL, '$nom' , ' $prenom' , 

*'$depart' , '$mail')"; <— © 

$id_base = sql ite_open( 'C:/wamp/www/sql itemanager/sportifs ' , 0666,$erreur) ; 

$resul t=sqlite_exec($id_base,$requete) ; <— © 

if(!$result) 

{ 
echo "<h2>Erreur d'insertion \n n'" ,sql ite_last_error($id_base) , "</h2>" ; <— © 

} 

else 

{ 
echo "<script type=\"text/javascript\"> 
alert('Vous etes enregistre Votre numero de client est : ". 
**sqlite_last_insert_rowid($id_base) . " ' )</script>" ; <— © 

} 

sqlite_close($id_base) ; <— © 
} 

else {echo "Formulaire a completer!";} 
?> 

</body> 
</html> 
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La figure 18-5 illustre la page de saisie et la boite d'alerte qui indique l'identifiant du 
client apres l'insertion. 
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Figure 18-5 

La page a" insertion et I'afflchage du code 



Les transactions 



Dans le cas de la base sportifs, que vous aurez a developper au chapitre 21, quand un 
utilisateur s'inscrit sur le site, il saisit ses coordonnees, le sport qu'il pratique et son niveau. 
Lorsqu'il valide son formulaire, il faut que le script realise les operations suivantes : 

1. Recuperation des coordonnees du visiteur, du sport et du niveau indique dans des 
variables PHP. 

2. Creation de la requete d'ecriture des coordonnees dans la table personne. 

3. Recuperation de l'identifiant du visiteur, qui a ete cree dans la table personne, dans la 
colonne id_personne. 

4. Recuperation de l'identifiant du sport choisi par le visiteur. 

5. Requete d'ecriture de l'identifiant du visiteur, de l'identifiant du sport et du niveau 
dans la table pratique qui represente l'association entre une personne et un sport. 

Si les deux requetes SQL sont executees sans probleme, il n'y a pas a se poser de ques- 
tion. Mais que se passe-t-il si, apres l'envoi de la premiere requete ou apres la lecture de 
l'identifiant du visiteur, la connexion a la base est interrompue pour une raison quel- 
conque (panne du serveur, erreur dans la deuxieme requete, etc.) ? Vous vous retrouvez 
dans la situation oil une personne est enregistree dans la base mais ne correspond a aucun 
sport, ce qui cree une incoherence dans la base. 
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Pour eviter cela, le langage SQL propose le mecanisme des transactions, qui consiste a 
delimiter un ensemble de requetes qui doivent etre executees en bloc ou pas du tout. En 
cas de probleme avant l'execution de la deuxieme requete SQL, l'effet de la premiere 
dans la table personne est annule. La base conserve ainsi son integrite. 

Examinez d'abord les risques encourus quand les transactions ne sont pas utilisees. 
L'exemple 18-5 illustre ces dangers. La requete qui va etre envoyee par la fonction 
sql ite_exec( ) contient deux parties. La premiere commande insere des donnees dans la 
table personne (repere Q) et la seconde dans la table pratique (repere @). Une erreur est 
creee volontairement dans cette deuxieme partie car la table pratiques n'existe pas. 
Quand la requete est envoyee a la base, le controle effectue par 1' instruction if 
(repere ©) affiche que la requete n'a pas ete executee, et un message d'alerte est affiche 
(repere ©). 

En visualisant le contenu de la table personne avec SQLiteManager, vous pouvez 
constater que les donnees concernant les coordonnees du visiteur ont quand meme ete 
inserees dans cette table. Par contre, il n'y a eu aucune insertion dans la table pratique. 
La base a perdu son integrite car elle contient une ligne dans la table personne qui n'est en 
liaison avec aucune autre dans la table pratique. 

Exemple 18-5. Le danger des requetes sans transactions 

<?php 

if ($id_base = sql ite_open( 'C:/wamp2/apps/sql itemanagerl .2.0/sportifs' )) 

{ 

$requete="BEGIN TRANSACTION trans;"; 
sqlite_exec($id_base,$requete) ; 

$requete="INSERT INTO personne(id_personne,nom,prenom > depart,mail ) 

**• VALUES (NULL, 'Spencer' , 'Marc' , '75' , 'marc@spen.org' ) ; " ; 

$testl= sqlite_exec($id_base,$requete) ; 

$requete="INSERT INTO pratiques(id_personne,id_sport, niveau) 

*VALUES(last_insert_rowid(),2,3) : "; 

$test2= sqlite_exec($id_base,$requete) ; 

if($testl and $test2 ) 
{ 

$requete="COMMIT TRANSACTION trans"; 

sql ite_exec($id_base,$requete) ; 

echo "<br />La requete est executee<hr />"; 
} 

else 
{ 

$requete="ROLLBACK TRANSACTION trans"; 

sql ite_exec($id_base,$requete) ; 

echo "La requete n'est pas executee"; 
} 

sql ite_close($id_base) ; 
} 
else 
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echo "ERREUR !"; 
} 

?> 

Pour supprimer ce danger, il faut utiliser les transactions en delimitant 1' ensemble des 
commandes SQL a executer en tout-ou-rien par la commande BEGIN TRANSACTION avant 
toute autre commande et par la commande COMMIT TRANSACTION apres la derniere. Tant que 
cette commande n'est pas rencontree, aucune insertion n'a lieu. Apres son apparition, 
1' ensemble des insertions est realise en bloc. 

L'exemple 18-6 reprend la meme insertion que l'exemple 18-5 en y ajoutant la commande 
BEGIN TRANSACTION (repere Q) puis l'envoi de deux requetes d'insertion dans les tables 
personne (repere ©) et pratiques (repere © avec une erreur volontaire sur le nom de la 
table). Si les deux requetes sont bien executees, la transaction est validee avec l'envoi de 
la commande COMMIT TRANSACTION (repere ©), qui evite le danger de l'insertion de lignes 
orphelines. Dans le cas contraire l'ensemble des insertions (sauf les eventuelles comman- 
des SELECT) est supprime a l'aide de la commande ROLLBACK TRANSACTION (repere ©). 

Exemple 18-6. Utilisation d'une transaction 

<?php 

if ($id_base = sqlite_open( 'C:/wamp/apps/sql itemanagerl.2.0/sportifs' ) ) 

{ 

$requete="BEGIN TRANSACTION trans;"; <-© 
sql ite_exec($id_base,$requete) ; 

$requete="INSERT INTO personne(id_personne, nom, prenom, depart, mail ) 

*» VALUES (NULL, 'Spencer' , 'Marc' , '75' , 'marc@spen.org' ) ; " ; 

$testl= sqlite_exec($id_base,$requete) ; <— © 

$requete=" INSERT INTO pratiques(id_personne,id_sport, niveau) 

*-VALUES(last_insert_rowid(),2,3);"; 

$test2= sqlite_exec($id_base,$requete) ; <— © 

if($testl and $test2 ) 
{ 

$requete="COMMIT TRANSACTION trans"; <-© 

sqlite_exec($id_base,$requete) ; 

echo "<br />La requete est executee<hr />"; 



$requete="ROLLBACK TRANSACTION trans"; ^© 

sql ite_exec($id_base,$ requete) ; 

echo "La requete n'est pas executee"; 
} 
sql ite_close($id_base) ; 
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I echo "ERREUR !"; 

L'erreur sur le nom de la table pratiques etant maintenue, le script affiche le meme 
message d'erreur et le meme avis que precedemment, mais cette fois vous etes assure 
qu'aucune donnee parasite ne figure dans la base. La commande COMMIT peut aussi etre 
envoyee separement des autres et apres avoir envoye d'autres requetes, comme c'est le cas 
ici. Ce n'est qu' apres cet envoi que les commandes precedentes ont un effet dans la base. 

Lecture des resultats d'une requete 

Comme avec MySQL, vous pouvez recuperer les resultats d'une requete de selection de 
plusieurs manieres differentes, dans un tableau ou une chaine mais egalement dans un 
objet. 

Lecture a I'aide d'un tableau 

Si la requete retourne des donnees de la base, la fonction sql ite_query( ) retourne une 
variable de type resource. Cette derniere sert de parametre pour les fonctions de lecture 
des donnees. Vous retrouvez ici des fonctions similaires a celle de la bibliotheque MySQL. 

La plus courante est la fonction sql ite_fetch_array ( ), dont la syntaxe est la suivante : 

array sql ite_fetch_array ( resource $result [, i nt tab_type]) 

Lors de son premier appel, elle retourne un tableau contenant les donnees de la premiere 
ligne du resultat Sresult retourne par sql ite_query( ). A chaque nouvel appel, ce tableau 
contient la ligne suivante. Pour lire 1' ensemble des donnees par une requete de selection, 
il faut realiser une boucle while. La constante tabjype determine le type du tableau 
retourne. Elle vaut SQLITE_NUM pour un tableau indice, SQLITE_ASSOC pour un tableau asso- 
ciatif ou SQLITE_BOTH (valeur par defaut) pour un tableau possedant a la fois des indices et 
des cles. 

L'exemple 18-7 utilise cette fonction. L'envoi de la requete de selection est effectue a 
I'aide de la fonction sql i te_query( ), et les resultats sont identifies par la variable $resul t 
(repere Q). Une boucle whi 1 e permet d'effectuer une lecture de l'ensemble en recuperant 
chaque ligne dans le tableau associatif $ligne (repere©). Ses elements permettent de 
creer un affichage XHTML approprie (reperes © et ©). 

<** Exemple 18-7. Lecture des resultats d'une requete 

<?php 

if ($id_base = sqlite_open ("C:/wamp/apps/sql itemanagerl .2.0/sportifs" , 0666, 

**$erreur) ) 

{ 

Srequete = "SELECT nom.prenom FROM personne" ; 

if (Sresult = sqlite_query ($id_base, Srequete)) <— © 

{ 
echo "<h3>Liste des personnes enregistrees</h3>" ; 
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while($ligne=sqlite_fetch_array($result,SQLITE_ASSOC)) <— © 
{ 
echo "Norn : <b>{$l igne["nom"]}</b>  ";<— © 
echo "Prenom : <b>{$l igne["prenom"]} </b><br />";<—© 
} 
} 

else echo " La requete n'a pas aboutie" ; 
sql ite_close($id_base) ; 
} 

else echo Serreur ; 
?> 

Ce script affiche la liste des personnes inscrites dans la table personne. 
Liste des personnes enregistrees 



L 


gne 





nom 


Cissai . . 


prenom : 


Gabri 


L 


gne 


1 


nom 


Dupont. . 


prenom : 


Mack. 


L 


gne 


2 


nom 


Valmont . 


. prenom 


Paul 



Ligne 8 : nom : Zidene... prenom : Zazou. 



II est possible de recuperer en une seule fois toutes les lignes de resultats dans un seul 
tableau en utilisant la fonction sql ite_fetch_al 1 ( ), dont la syntaxe est la suivante : 

array sql ite_fetch_all (resource $result [, int tab_type]) 

Elle utilise encore un identifiant de resultat retourne par la fonction sql ite_query( ). Le 
tableau retourne est multidimensionnel, chacun de ses elements etant lui-meme un 
tableau. Vous devez utiliser deux boucles imbriquees pour lire 1' ensemble des donnees. 
L'exemple 18-8 realise la meme operation que l'exemple 18-7 en utilisant cette fonction. 
Le tableau retourne par la fonction sqlite_fetch_all() contient ici toutes les lignes du 
resultat (repere ©). Vous utilisez deux boucles imbriquees for (repere ©) et foreach 
(repere ©) pour parcourir ce tableau et afficher l'ensemble des donnees. 

Exemple 18-8. Lecture de l'ensemble des lignes 

<?php 

if ($id_base = sqlite_open ("C:/wamp/apps/sql itemanagerl.2.0/sportifs" , 0666, 
*»$erreur) ) 
{ 
$requete = "SELECT nom, prenom FROM personne" ; 
if (Sresult = sqlite_query ($id_base, Srequete)) 
{ 
echo "<h3>Liste des personnes enregistrees</h3>" ; 
$lignes=sqlite_fetch_all (Sresult, SQLITE_ASS0C); <-© 
for($i=0;$i<count($lignes );$i++) <— © 
{ 
echo "Ligne $i :   " ; 
foreach($lignes[$i] as $cle=>$valeur) <— © 
{ 
echo $cle," :   " ,$valeur, " . . .  " ; 
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echo "<br />"; 



else echo " La requete n'a pas aboutie" ; 
} 

else echo Serreur ; 
?> 

Quand il est previsible que la requete ne retourne qu'un nombre limite de lignes, que 
vous estimez a une quarantaine au maximum, il peut etre plus rapide d'utiliser la fonction 

sql ite_array_query( ), dont la syntaxe est semblable a celle de sql ite„query( ) : 

array sql ite_array_query (resource $id_base, string Srequete [,int tab_type]) 

Elle envoie la requete a la base identifiee par $i debase et retourne directement chaque 
ligne de donnees dans un tableau indice ou associatif selon la valeur de la constante tab_ 
type. Si la requete porte sur plusieurs attributs d'une table, le tableau retourne est toujours 
multidimensionnel. L' element d' indice est un tableau indice ou associatif selon la 
valeur du troisieme parametre. II contient les donnees de la premiere ligne de resultats. Si 
ce tableau est associatif, les cles sont les noms des colonnes de la table, et les valeurs 
celles des champs correspondants. 

L'exemple 18-9 illustre cette possibilite de lecture des resultats d'une requete de selec- 
tion. Le tableau multidimensionnel $lignes obtenu (repere O) est m a l'aide de deux 
boucles imbriquees. La premiere boucle for parcourt les elements du tableau $lignes 
(repere ©), et la seconde boucle foreach lit les elements du tableau associatif $lignes[$i] 
en recuperant les cles et les valeurs associees (repere ©). 

Exemple 18-9. Lecture de I'ensemble des lignes 

<?php 

if ($id_base = sqlite_open ( "C:/wamp/apps/sql itemanagerl .2.0/sportifs" , 0666, 
*»$erreur) ) 
{ 
Srequete = "SELECT nom.prenom.mail FROM personne" ; 
echo "<h3>Liste des personnes enregistrees</h3>" ; 
$1 ignes=sql ite_array_query($id_base,$requete,SQLITE_ASSOC) ; <— © 
for($i=0;$i<count($lignes);$i++) <— Q 
{ 
echo "Ligne $i :  "; 
foreach($lignes[$i] as $cle=>$valeur) <— © 
{ 

echo $cle," :   " ,$valeur, " . . .  " ; 
} 

echo "<br />" ; 
} 

sql ite_close($id_base) ; 
} 

else echo Serreur ; 
?> 
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Pour des recherches particulieres, qui ne concernent qu'une seule colonne de la table 
interrogee, il est plus rapide de lire le resultat a l'aide de la fonction sqlite_fetch_ 
singlet), qui retourne a chaque appel uniquement la premiere colonne de chaque ligne 
du resultat $resul t obtenu apres une requete. 

La syntaxe de cette fonction est la suivante : 

string sql ite_fetch_single (resource Sresult) 

Elle est utilisee dans l'exemple 18-10 pour trouver l'adresse e-mail d'une personne dont 
le nom est connu (repere Q)- Apres 1' appel de cette fonction, la variable $1 igne contient 
l'adresse e-mail recherchee (repere ©). Notez que si le resultat contient plusieurs lignes, 
un nouvel appel de la fonction retourne la valeur de la premiere colonne de cette seconde 
ligne, et ainsi de suite. 

Exemple 18-10. Lecture d'une seule colonne 

<?php 

if ($id_base = sqlite_open ("C:/wamp/apps/sqlitemanagerl.2.0/sportifs" , 0666, 

^Serreur) ) 

{ 

$requete = "SELECT mail FROM personne WHERE nom='Engels '" ; <— © 

if (Sresult = sql ite_query ($id_base, Srequete)) 

{ 
$ligne=sqlite_fetch_single( Sresult); <— © 
echo "<h3>Mail : $1 igne</h3>" ; 

} 

else echo " La requete n'a pas aboutie" ; 
} 

else echo Serreur ; 
?> 

Pour lire n'importe quelle colonne particuliere d'un resultat, vous devez utiliser la fonc- 
tion : 

mixed sql ite_col umn (resource Sresult, mixed num|nom) 

qui retourne la valeur de la colonne precisee soit par sa position numerique dans la 
requete, soit par son nom ou son alias. Chaque nouvel appel de cette fonction retourne 
la ligne suivante du resultat. 

Informations sur le resultat 

A partir d'un resultat de requete, vous pouvez obtenir des renseignements sur les donnees 
retournees par une requete de selection. La fonction suivante : 

| string sqlite_field_name (resource Sresult, int num) 

retourne le nom de la colonne situee a la position num dans la requete, et non dans la table. 
Elle peut servir a faciliter la lecture du resultat quand la requete est construite dynami- 
quement a partir de choix operes par le visiteur. 
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Pour obtenir le nombre de colonnes d'un resultat, vous disposez de la fonction sql 1te_ 
num_fields(), dont la syntaxe est la suivante : 

int sql ite_num_fi elds (resource Sresult) 

Le nombre de lignes du resultat peut etre obtenu en appelant la fonction sqlite_num_ 
rows( ), dont la syntaxe est la suivante : 

int sql ite_num_rows (resource $result) 

Elle peut etre utilisee, par exemple, pour afficher le nombre de resultats ou pour creer des 
boucles for de lecture de l'ensemble des lignes d'un resultat a la place d'une boucle 

whi le. 

Quand vous effectuez une requete de mise a jour ou de modification de lignes de une ou 
plusieurs tables, vous pouvez obtenir le nombre de lignes qui ont ete modifiees grace a la 
fonction sql i te_changes ( ) , dont la syntaxe est la suivante : 

int sql ite_changes (resource $id_base) 



Precaution 

Le nombre retourne concerne toute la base et non pas une seule table. En effet, une requete peut concer- 
ner plusieurs tables ! 



Lecture dans un objet 

Comme vous l'avez deja vu avec MySQL, il est possible de recuperer les donnees issues 
d'une requete de selection dans un objet grace a la fonction sql i te_fetch_object( ) , dont 
la syntaxe est la suivante : 

j object sqlite_fetch_object (resource Sresult) 

L'objet retourne a autant de proprietes que la requete SQL a selectionne de colonnes 
dans une ou plusieurs tables de la base. Le nom de ces proprietes est celui des colonnes 
de la table ou des alias eventuels. A chaque nouvel appel, l'objet retourne contient done 
la ligne suivante du resultat identifie par $ r e s u 1 1 obtenu par la fonction s q 1 1 1 e_q u e ry ( ) . 

L'exemple 18-11 reprend la lecture de la totalite de la table personne et affiche les noms 
et prenoms de l'ensemble des personnes enregistrees ainsi que leur e-mail. Vous utilisez 
encore une boucle while pour parcourir toutes les lignes du resultat (repere ©). II est 
possible d' afficher les valeurs de chaque colonne en affichant les proprietes de l'objet 
$obj (reperes ©, © et ©) au moyen de la syntaxe $nom_objet->nom_prop. Si vous utilisez 
un alias, le nom de la propriete est bien celui de 1' alias et non plus celui de la colonne de 
la table (repere 0). 

Exemple 18-11. Lecture a I'aide d'un objet 

<?php 

if ($id_base = sqlite_open ( "C:/wamp/apps/sql itemanagerl .2.0/sportifs" , 0666, 

*»$erreur)) 

( 
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Srequete = "SELECT nom.prenom.mail AS 'adresse_mail ' FROM personne" 
if (Sresult = sqlite_query ($id_base, Srequete)) 
{ 
$nb=sqlite_num_rows($ result) ; 

echo "<h3>l_iste des $nb personnes enregistrees</h3>" ; 
while ($obj=sqlite_fetch_object($ result)) <— © 
{ 
echo " <b>$obj->nom</b>  ";<— © 
echo " <b>$obj->prenom</b> :  ";<— © 
echo " <b>$obj->adresse_mail</b>  ";<— © 
echo "<br />"; 



else echo " La requete n'a pas aboutie" 

sql ite_close($id_base) ; 
} 

else echo Serreur ; 
?> 



Acces a une ligne quelconque d'un resultat 

Les fonctions precedentes retournent generalement une ligne de donnees puis pointent 
sur la suivante et obligent a effectuer un parcours sequentiel des lignes du resultat. Un 
ensemble de fonctions permettent la lecture des lignes dans un ordre quelconque. Cela 
introduit la notion de pointeur de resultat, comme il existe un pointeur de tableau. 

La fonction sql 1 te_seek( ) permet de positionner le pointeur a la ligne desiree. Sa syntaxe 
est la suivante : 

| boolean sqlite_seek(resource Sresult, integer num_ligne) 



Indice de premiere ligne 

Prenez garde a nouveau que la premiere ligne a I'indice 0. 



Elle retourne TRUE si l'operation est realisee et FALSE dans le cas contraire (si la ligne 
demandee n' existe pas). 

La fonction sql 1te_next(), dont la syntaxe est la suivante : 

| boolean sqlite_next(resource Sresult) 

pointe quant a elle sur la ligne suivante du resultat et retourne egalement TRUE ou FALSE 
dans les memes conditions. 

La fonction sql ite_rewind( ) replace le pointeur de resultat sur la premiere ligne, ce qui 
permet de recommencer la lecture. Sa syntaxe est la suivante : 

boolean sql ite_rewind(resource $result) 

Elle retourne egalement une valeur booleenne. 
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Pour savoir s'il reste encore des lignes a lire dans le resultat, vous pouvez avoir recours a 
la fonction sql ite_has_more( ), dont la syntaxe est la suivante : 

boolean sql ite_has_more(resource Sresult) 

et qui retourne aussi une valeur booleenne si la condition est verifiee. 

La seule fonction de lecture de la ligne en cours designee par le pointeur de resultat a 
l'aide des fonctions ci-dessus est sql ite_current( ), dont la syntaxe est la suivante : 

| array sqlite_current(resource Sresult, integer tab_type) 

Elle retourne la ligne en cours dans un tableau indice ou associatif selon la valeur de la 
constante tab_type, laquelle vaut encore SQLITE_BOTH par defaut. Contrairement aux fonc- 
tions de lecture deja rencontrees, par exemple, sqlite_fetch_array(), apres l'appel de 
sql ite_current( ), le pointeur de resultat n'est pas place sur la ligne suivante. II faut utili- 
ser les fonctions precedentes pour le deplacer selon les besoins. Pour lire rapidement 
1' ensemble des resultats dans l'ordre normal, vous ne pouvez done pas envisager d'utili- 
ser cette fonction, qui est plus adaptee a une lecture dans un ordre irregulier. 

L'exemple 18-12 utilise la plupart des fonctions precedentes pour effectuer une lecture 
particuliere des resultats. Apres l'ouverture de la base et l'envoi de la requete de la 
maniere habituelle, vous recuperez le nombre total de lignes du resultat dans la variable 
$max (repere ©). Ce nombre est utilise pour creer la condition d'arret d'une boucle for 
(repere ©), qui vous permet de lire les lignes de cinq en cinq a partir de la troisieme 
(d'indice 2). A l'interieur de cette boucle, le pointeur est place a la position $i par 
la fonction sqlite_seek() (repere©). La ligne est lue (repere©) puis affichee avec la 
fonction pri nt_r( ) (repere ©). 

Apres chaque lecture, vous controlez s'il existe encore des lignes a lire (repere ©). Si 
e'est le cas, le pointeur est place sur la ligne suivante (repere ©), qui est lue a son tour 
(repere @). 

La table personne contient ici treize enregistrements, dont les indices varient de a 12 
dans le resultat. La boucle for lit done les lignes d'indice 2, 7 et 12, tandis que l'utilisa- 
tion de la fonction sqlite_next() permet de lire les lignes d'indice 3 et 8. La fonction 
sqlite„has_more() realise un test qui permet d'eviter une erreur en tentant de lire une 
ligne d'indice 13, qui n'existe pas. 

Exemple 18-12. Lecture irreguliere des lignes 

<?php 

if ($id_base = sqlite_open ( "C:/wamp/apps/sql itemanagerl .2.0/sportifs" , 0666, 
*»$erreur) ) 
{ 
Srequete = "SELECT id_personne,nom FROM personne" ; 
if (Sresult = sqlite_query ($id_base, Srequete)) 
{ 
$max=sql ite_num_rows( Sresult) ; <— © 
for(Si=2;Si<Smax;Si+=5) <^© 
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sqlite_seek($result,$i ) ; <— © 
$ligne=sqlite_current($result,SQLITE_ASSOC); <— O 
print_r($ligne) ; <— © 
echo "<hr />"; 

if (sql ite_has_more($resul t) ) <— © 
{ 
sqlite_next($result) ; <— © 

$ligne=sqlite_current($result,SQLITE_ASSOC); <— © 
print_r($l igne) ; 
echo "<hr />"; 
} 
} 
} 

else echo " La requete n'a pas aboutie" ; 
sql ite_close($id_base) ; 
} 

else echo "ERREUR : ",$erreur ; 
?> 

Vous obtenez un resultat de la forme suivante, dans lequel le premier nombre est la valeur 
de l'identifiant de chaque personne dans la table. 

Array ( [id_personne] => 3 [nom] => Valmont ) 

Array ( [id_personne] => 4 [nom] => Qwetz ) 

Array ( [id_personne] => 8 [nom] => Engels ) 

Array ( [id_personne] => 9 [nom] => Zidene ) 

Array ( [id_personne] => 13 [nom] => Wind ) 



Creation de fonctions SQL personnalisees 

Le langage SQL offre un grand nombre de fonctions utilisables dans les requetes. Au cas 
oil vous auriez besoin d'une fonction qui n'existe pas, SQLite vous permet de creer vos 
propres fonctions et de les enregistrer. L'avantage de cette technique est qu'une fonction 
ecrite dans une requete est appliquee automatiquement a toutes les lignes du resultat pour 
les colonnes choisies dans la requete SQL. Cela evite de devoir effectuer un traitement 
repetitif a posteriori sur les donnees apres lecture des lignes. 

Pour parvenir a ce resultat, il suffit de suivre les deux etapes suivantes : 

1. Creez une fonction personnalisee a l'aide de code PHP selon la methode habituelle 
(voir le chapitre 7). 

2. Declarez cette fonction comme utilisable par SQLite a l'aide de la fonction sqlite_ 
create_function( ), selon la syntaxe suivante : 



I bo 



oolean sql ite_create_function(resource $id_base, string nom_sql , string nom_php 
[.integer nb_param]) 
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Le parametre nom_sql est le nom qui servira a appeler la fonction personnalisee dans le 
code SQL. II doit etre different d'un nom de fonction SQL existant. Le parametre nom_php 
est le nom de la fonction personnalisee qui a ete creee dans le code PHP a l'etape prece- 
dente. Le parametre nb_param precise le nombre de parametres necessaires a cette fonc- 
tion. Bien que facultatif, il est preferable de l'utiliser pour les fonctions ayant un nombre 
fixe de parametres. 

Pour utiliser une fonction PHP native dans une requete SQL, la technique est encore plus 
simple car vous disposez d'une fonction generaliste speciale nominee php(), qu'il n'est 
pas necessaire d'enregistrer avec sql ite_create_f unction ( ). 

La fonction php( ) s'utilise directement dans une requete selon la syntaxe suivante : 

php(string nom_php, nom_colonne) 

Le parametre nom_php doit designer une des fonctions natives de PHP, a condition qu'elle 
puisse recevoir comme parametre une valeur compatible avec celle de la colonne a 
laquelle elle s' applique. 

Si vous ecrivez, par exemple, le code suivant : 

$requete="SELECT php( 'strtoupper' ,nom) , php( 'strtolower' .mail ) FROM personne"; 

vous obtenez la liste de tous les utilisateurs, avec leur nom en majuscules et leur e-mail 
en minuscules, quelles que soient les casses des donnees de la base. 

L'exemple 18-13 cree une fonction personnalisee nominee present, qui retourne une 
chaine dont l'initiale seule est en majuscule (repere ©)• Cette fonction est enregistree 
par SQLite sous le nom initiale (repere @). Elle est ensuite utilisee sous ce nom dans 
une requete SQL (repere ©). Dans la meme requete, vous utilisez une fonction native du 
langage SQL, la fonction upper( ), et une fonction native de PHP par 1' intermediate de la 
fonction generale php( ) (repere @). L'affichage des resultats est ensuite realise en utili- 
sant les indices du tableau $1 i gne (repere ©) puis les cles de ce meme tableau (repere ©). 



Attention 

Pour utiliser les cles du tableau $lignes, vous devez imperativement definir des alias. Ces demiers 
doivent etre les cles du tableau pour les colonnes auxquelles vous appliquez des fonctions personnalisees 
ou PHP, faute de quoi vous n'obtenez aucun resultat. Cela n'est pas necessaire si vous utilisez seulement 
les indices pour l'affichage des donnees. 



Exemple 18-13. Creation d'une fonction SQL 

<?php 

function present($mot) <— O 



{ 



return ucfirst(strtolower($mot) ) ; 
} 

if ($id_base = sqlite_open ( "C:/wamp/apps/sql itemanagerl .2.0/sportifs" , 0666, 
*»$erreur)) 

( 
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sql ite_create_function($id_base, ' Initial e" , 'present' , 1) ; <— © 
$requete = "SELECT upper(nom) AS nom, initiale(prenom) AS prenom, 
*»php( 'strtolower ' .mail ) FROM personne" ; <— © 
if (Sresult = sqlite_query ($id_base, Srequete)) 
{ 

echo "<h3>Liste des personnes enregistrees</h3>" ; 

while($ligne=sqlite_fetch_array($result,SQLITE_BOTH)) 



echo "Nom 
*"<br />" 

echo "Nom 



^O 



* $ligne['mail'] ,"<br />";^© 



else echo " La requete n'a pas aboutie" 

sql ite_close($id_base) ; 
} 

else echo $erreur ; 
?> 

Le resultat obtenu a la forme suivante : 



igne[0] ," Prenom : ", $ligne[l] , " Mail : ", $ligne[2], 
igne['nom'] ," Prenom : ", $1 igne[ 'prenom' ] , " Mail : ", 



Liste des personnes enregistrees 



om 


CISSAI 


Prenom 


om 


CISSAI 


Prenom 


om 


DUPONT 


Prenom 


om 


DUPONT 


Prenom 



Gabril Mail : gabril@qsdfg.com 

Gabril Mail : gabril@qsdfg.com 

Mack Mail : azertyu@sdfg 

Mack Mail : azertyu@sdfg 



La methode objet 

Le fait de pouvoir acceder de maniere native a une base SQLite a l'aide d'objets confirme 
1' orientation objet donnee a PHP 5. Meme si la methode objet est fondamentalement 
differente de la methode procedurale d'un point de vue conceptuel, vous retrouverez de 
nombreux points communs entre les methodes des objets manipules et les fonctions que 
vous avez utilisees precedemment. 

Tout l'acces a SQLite repose sur quatre objets ayant chacun un role precis. II s'agit des 
objets suivants : 

• SQLiteDatabase, qui permet l'ouverture de la base, l'envoi de requetes et la recupera- 
tion d' informations apres ces envois. 

• SQLiteResult, obtenu apres une requete qui retourne des donnees. Ses methodes 
permettent de lire les lignes de donnees retournees par les requetes de selection. 

• SQLiteUnbuffered, obtenu apres une requete non bufferisee. II a le meme role et les 
memes methodes que l'objet SQLiteResult. 

• SQLi teExcepti on, qui permet de gerer les erreurs. 
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Chacun de ces objets possede des methodes dont les actions sont similaires a celles des 
fonctions utilisees a la section precedente. Vous allez done reecrire les differents exem- 
ples de cette section en utilisant ces objets et ces methodes. 



Casse des noms de methode 

Tous les noms des methodes de ces objets sont insensibles a la casse. 



Acces a la base 



Pour acceder a une base SQLite, vous devez d'abord creer un objet SQLiteDatabase en 
utilisant le mot-cle new selon la syntaxe suivante, qui appelle le constructeur de la classe 
avec les memes parametres que la fonction sql ite_open( ) : 

$db=new SQLiteDatabase("C:/wamp/apps/sql itemanagerl.2.0/sportifs" , 0666, Serreur); 

Si la base n'existe pas, elle est creee. Le premier parametre, qui indique le nom et le 
chemin d' acces a la base, est obligatoire. Si le premier parametre est la chaine " : memory : ", 
la base est creee en memoire vive du serveur. Pour fermer la base, vous detruisez la varia- 
ble $db en appelant la fonction unsetO aussitot que vous n'en avez plus besoin, done juste 
apres 1' envoi de la derniere requete du script. 



Envoi de requites 



L'objet $db qui vient d'etre cree va etre utilise pour envoyer des requetes a la base avec la 
methode queryt ). Cette derniere est equivalente a la fonction sql ite_query( ), dont le seul 
parametre est la chaine de la requete SQL. Pour les requetes de selection de donnees, 
cette methode retourne un objet SQLiteResult, dont l'utilisation est detaillee a la section 
suivante. 

Si la requete n'est pas executee, la methode retourne la valeur booleenne FALSE. L'exem- 
ple 18-14 represente la forme generale d'un script d'ouverture de la base et d'envoi d'une 
requete. II equivaut a l'exemple 18-1 mais avec la methode objet. 

Exemple 18-14. Script type d'acces a la base 

<?php 

if ($db=new SQLiteDatabase ( "C:/wamp/apps/sql itemanagerl .2.0/sportifs" , 0666, 
*»$erreur)) 
{ 
Srequete = "SELECT nom.prenom FROM personne" ; 
if ($ res ult=$db->query($ requete)) 
{ 
unset($db); 

echo " La requete a ete effectuee " ; 
//Lecture des resultats 
} 
else echo " La requete n'a pas aboutie" ; 
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I else echo Serreur ; 
?> 

Pour que le resultat ne soit pas mis en buffer sur le serveur, vous pouvez utiliser la 
methode unbufferedQueryO a la place de queryO. Elle recoit les memes parametres et 
retourne un objet de type SQLiteUnbuffered au lieu de SQLiteResult. Ces deux objets ont 
les memes methodes, detaillees a la section suivante. 

Pour les requetes ne retournant pas de donnees, comme les creations de tables ou les 
mises a jour, par exemple, vous pouvez utiliser la methode queryExect ) avec les memes 
parametres que queryO. Elle est plus rapide que cette derniere et retourne TRUE si la 
requete est bien executee et FALSE dans le cas contraire. 

Si la requete de selection a envoyer ne retourne qu'un nombre limite de lignes de resul- 
tats, il est plus rapide d'utiliser la methode arrayQueryt ), qui permet a la fois d'envoyer la 
requete et de retourner un tableau contenant 1' ensemble des resultats. Cette methode 
permet de ne pas utiliser d'objet SQLiteResult. Sa syntaxe est la suivante: 

Array $db->arrayQuery(string Srequete, int tab_type) 

Le premier parametre contient la requete SQL. Le second, tab_type, est une constante qui 
determine le type du tableau retourne. II prend les valeurs SQLITE_NUM, SQLITE_ASSOC ou 
SQLITE_BOTH, selon que le tableau est indice, associatif ou les deux. 

Si la requete porte sur plusieurs colonnes d'une table, le tableau est toujours multidimen- 
sionnel. L' element d' indice est un tableau qui contient les donnees de la premiere ligne 
de resultats. Quand il est associatif, ses cles sont les noms des colonnes ou des alias de la 
requete. 

L'exemple 18-15 illustre la lecture de la table personne au moyen de la methode objet. 
Apres la creation de l'objet $db de type SQLiteDatabase (repere ©), l'envoi d'une requete 
de selection par la methode arrayQuery( ) retourne un tableau multidimensionnel indice, 
dont les elements sont des tableaux associatif s (repere ©). Ce tableau est lu a l'aide de 
deux boucles imbriquees, une boucle for pour le premier niveau (repere ©) et une 
boucle f o reach pour les tableaux associatifs (repere ©). Les cles de ces derniers, qui sont 
les noms des colonnes de la selection, sont utilisees pour creer un affichage XHTML des 
donnees (repere 0). 

Exemple 18-15. Requete de selection de donnees 

<?php 

if ($db=new SQLiteDatabase("C:/wamp/apps/sql itemanagerl.2.0/sportifs" , 0666, 
*$erreur)) <— Q 
{ 
$requete = "SELECT nom.prenom FROM personne" ; 
if ($result=$db->arrayQuery($requete,SQLITE_ASS0O) <— Q 
{ 
for($i=0;$i<count($result);$i++) <^@ 
{ 
echo "Ligne $i :   " ; 
foreach($result[$i] as $cle=>$valeur) <— © 
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echo $cle," :   " ,$valeur, " . . .  " ; <— Q 
} 

echo "<br />"; 
) 
} 

else echo " La requete n'a pas aboutie" ; 
} 

else echo Serreur ; 
?> 

Le resultat de ce script est de la forme suivante: 



Ligne 
Ligne 1 
Ligne 2 



nom 
nom 
nom 



Cissai . . . 


prenom 


Gabri 


Dupont. . . 


prenom 


Mack. 


Valmont. . 


prenom 


Paul. 



Pour des recherches encore plus restreintes, comme celle visant a retrouver l'adresse e-mail 
d'une personne donnee, il est possible d'envoyer la requete et de recuperer le resultat en une 
seule operation, en appelant la methode si ngl eQuery ( ), dont la syntaxe est la suivante : 

$db->singleQuery( string $ requete) 

Si la requete ne retourne qu'une seule valeur, comme a l'exemple 18-16 (repere ©), elle 
retourne une chaine ou un nombre contenant cette valeur, qu'il est tres simple d'utiliser 
comme variable scalaire (repere ©). Si la requete retourne plusieurs lignes de donnees, 
la methode retourne un tableau indice ne contenant que les valeurs de la premiere colonne 
de la requete SQL. 

Si, par exemple, la requete est la suivante : 

|$requete = "SELECT mail , nom, prenom FROM personne"; 
if ($ res ult=$db->si ngl eQuery($ requete)) 

la variable $resul t est un tableau indice dont les elements sont toutes les adresses e-mail de 
la table personne. Les autres colonnes de la requete ne sont pas presentes dans le resultat. 

Exemple 18-16. Lecture d'une seule valeur 

<?php 

if ($db=new SQLiteDatabase("C:/wamp/apps/sqlitemanagerl.2.0/sportifs" ) ) 

{ 

Srequete = "SELECT mail FROM personne WHERE nom=' Engels ' " ; 

if ($result=$db->singleQuery($requete)) <— O 

{ 
echo "Mail : Sresult <br />";<—© 

1 

else echo " La requete n'a pas aboutie" ; 
} 

else echo $erreur ; 
?> 
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L'objet SQLiteDatabase dispose egalement de la methode lastErrorO, qui retoume le 
code de la derniere erreur survenue dans le script. Si aucune erreur ne s'est produite, elle 
retourne la valeur 0. 

Quand vous effectuez une requete de mise a jour ou de modification de donnees sur une 
ou plusieurs lignes des tables de la base, vous pouvez obtenir le nombre de lignes qui ont 
ete modifiees en utilisant la methode changes ( ), dont la syntaxe est la suivante : 

int $db->changes() 

L'exemple 18-17 realise une mise a jour des donnees dans la table personne a l'aide de la 
commande SQL UPDATE (repere©). Apres l'envoi de la requete avec la methode 
queryExec( ), plus appropriee ici (repere ©), la methode changes( ) permet de lire et d'affi- 
cher le nombre de lignes modifiees (repere ©). 

Exemple 18-17. Determination du nombre de lignes modifiees 

<?php 

if ($db=new SQLiteDatabase("C:/wamp/apps/sql itemanagerl.2.0/sportifs" ) ) 

{ 

$requete = "UPDATE personne SET mail ='romy@funhtml .com' WHERE 

*»nom=' Engel s ' " ; <— O 

if ($result=$db->queryExec($requete)) <— © 

{ 

echo "II y a " ,$db->changes( ) , " ligne(s) modifiee(s)" ; <— © 

} 

else echo " La requete n'a pas aboutie" ; 
} 

else echo Serreur ; 
?> 

Apres insertion de donnees dans une table comportant une colonne d'identifiant entier 
auto-incremente declare par la clause "INTEGER PRIMARY KEY" lors de la creation de la table, 
vous pouvez recuperer la valeur qui vient d'etre inseree dans cette colonne a l'aide de la 
methode lastlnsertRowidO de l'objet $db. 

L'exemple 18-18 realise 1' insertion des coordonnees d'un visiteur dans la table personne 
avec la commande SQL INSERT (repere ©). Apres l'envoi de la requete avec la methode 
queryExec( ) (repere ©), le dernier identifiant insere est lu et affiche a destination du visi- 
teur (repere ©). 

Exemple 18-18. Lecture du dernier champ auto-incremente 

<?php 

if ($db=new SQLiteDatabase("C:/wamp/apps/sql itemanagerl.2.0/sportifs" ) ) 

{ 

$requete="INSERT INTO personne (id_personne, nom, prenom, depart, mail) 

LVALUES (NULL, 'Grouchi ' , 'Karl ' ,91, ' karl@grouch.net ')" ; <^© 

if ($result=$db->queryExec($requete)) <— © 
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echo "Votre identifiant est : " ,$db->lastInsertRowid( ) ; <— © 

} 

else echo " La requete n'a pas aboutie" ; 
} 

else echo $erreur ; 
?> 

Lecture des resultats et objets specialises 

L'objet SQLi teDatabase vous a deja permis une lecture de resultats dans des cas particuliers 
simples. Dans le cas general d'une requete qui retourne les resultats d'une selection 
portant sur un nombre quelconque de colonnes, vous utilisez systematiquement les 
methodes queryO ou unbufferedQueryO. La premiere retourne un objet de type 
SQLiteResult et la seconde un objet de type SQLiteUnbuffered. Ces deux types d'objets ont 
exactement les memes methodes. La seule difference entre eux reside dans le fait que le 
second represente un resultat qui n'est pas mis en buffer et qui doit done etre 
« consomme » tout de suite, en particulier avant tout autre envoi de requete. 

Les exemples qui suivent n'emploient que l'objet SQLiteResult. Si vous voulez obtenir 
des resultats non bufferises, il vous suffit de remplacer la methode query ( ) par la methode 

unbufferedQuery( ). 

Lecture a I'aide d'un tableau ou d'une chaine 

L'objet retourne par la methode query( ) est recupere dans la variable $resul t, dont vous 
allez utiliser les differentes methodes. La methode la plus courante est fetchO, equiva- 
lent de la fonction sqlite_fetch_array(). Elle retourne un tableau contenant la ligne en 
cours du resultat et prend comme seul parametre une des constantes SQLITE_NUM, SQLITE_ 
ASSOC ou SQLITE_BOTH, que vous avez deja rencontrees dans la methode procedurale et qui 
determine le type de tableau retourne. 

A chaque nouvel appel, cette methode retourne le contenu de la ligne suivante de resul- 
tats. Pour obtenir la totalite des donnees, vous ecrivez deux boucles imbriquees, une 
boucle whi 1 e pour chaque ligne et une boucle for ou f oreach pour lire les donnees d'une 
ligne. 

L'exemple 18-19 realise la meme lecture que l'exemple 18-4, mais avec une fonction. 
Apres l'ouverture de la base et la creation d'un objet SQLiteDatabase (repere ©), une 
requete SQL classique permet la selection de tous les noms et prenoms des utilisateurs 
inscrits dans la table personne (repere ©). L'envoi de la requete par la methode query( ) 
retourne un objet de type SQLiteResult dans la variable $result (repere ©). La destruc- 
tion de la variable objet $db est realisee aussitot apres pour liberer la base d'un 
verrouillage eventuel (repere ©). Une boucle whi 1 e lit alors chaque ligne dans un tableau 
associatif $1 igne en appelant la methode fetch ( ) (repere ©). Ce tableau est utilise pour 
lire chacune des donnees retournees par la requete (reperes © et ©). 
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Exemple 18-19. Lecture des resultats ligne par ligne 

<?php 

if ($db=new SQLiteDatabase("C:/wamp/apps/sql itemanagerl.2.0/sportifs" , 0666, 
*$erreur)) <^© 
{ 
$requete = "SELECT nom.prenom FROM personne" ; <— © 
if (Sresult = $db->query($requete) ) <— © 
{ 

unset($db); <-© 

echo "<h3>Li ste des personnes enregistrees</h3>" ; 
while($ligne=$result->fetch(SQLITE_ASS0O) <-© 
{ 
echo "Nom : <b>{$ligne["nom"]}</b>  ";<— © 
echo "Prenom : <b>{$l igne["prenom"]} </b><br />";<—© 



else echo " La requete n'a pas aboutie" ; 

} 
else echo $erreur ; 
?> 

Vous pouvez recuperer l'ensemble des lignes obtenues au moyen d'une requete de selec- 
tion dans un seul tableau multidimensionnel en utilisant la methode f etchAl 1 ( ) d'un objet 
SQLiteResult. Cette operation est rapide car elle ne realise qu'un seul appel de methode. 
II faut toutefois l'utiliser pour des requetes ne retournant qu'un nombre peu important de 
lignes. On imagine aisement l'espace memoire occupe par un tableau contenant quelques 
milliers de lignes. 

La methode f etchAl 1 ( ) utilise la syntaxe suivante : 

$db->fetchAll (string $requete,int tab_type) 

Le parametre tab_type, que vous avez utilise precedemment, specifie le type de tableau 
retourne. Le tableau etant multidimensionnel, a moins que la requete ne concerne qu'une 
colonne, vous devez utiliser deux boucles imbriquees pour le lire dans son ensemble. 

L'exemple 18-20 lit l'ensemble des resultats de la requete SQL. II s'agit d'une jointure 
des tables personne et pratique afin de rechercher les coordonnees des personnes prati- 
quant le sport dont l'identifiant est 2, soit le football (repere Q)- La requete envoyee par 
la methode query () retourne la variable $ result, qui est un objet SQLiteResult (repere ©). 
L'objet $db est alors detruit, ce qui libere la base (repere ©). 

L'appel de la methode fetchAHO pour l'objet $result retourne le tableau $tablignes 
(repere ©). L'objet $resul t peut alors etre detruit a son tour (repere ©). Les elements de 
Stablignes sont lus avec une boucle for (repere©). Chaque element note $tablignes[$i] 
est lui-meme un tableau associatif qui est lu avec une boucle fo reach (repere ©) et utilise 
pour creer un affichage des donnees (repere ©). 
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Exemple 18-20. Lecture de I'ensemble des lignes dans un seul tableau 

<?php 

if ($db=new SQLiteDatabase("C:/wamp/apps/sqlitemanagerl.2.0/sportifs" , 0666, 
*$erreur) ) 
{ 
Srequete = "SELECT nom, prenom, mail FROM personne, pratique WHERE id_sport='2' 
*»AND personne. id_personne=pratique.id_personne" ; <— © 
if (Sresult = $db->query($requete,SQLITE_ASSOC) ) <-© 
{ 
unset($db); <— © 

echo "<h3>Liste des personnes jouant au football</h3>" ; 
$tablignes=$result->fetchAll(SQLITE_ASSOC); <-© 
unset(Sresult); <— © 
f or ($i=0;$i<count($tablignes );$i++) <— © 
{ 
echo "Ligne $i :   " ; 

foreach($tablignes[$i] as $cle=>$valeur) <— © 
{ 

echo $cle," :   " ,$valeur," . . .  " ; <— © 
} 
echo "<br />"; 



else echo " La requete n'a pas aboutie" 
} 

else echo $erreur ; 
?> 

Le resultat de ce script a la forme suivante : 



Liste des personnes jouant au footbal 



Ligne 





nom 


Ligne 


1 


nom 


Ligne 


2 


nom 



Cissai... prenom : Gabril... mail : gabril@qsdfg.com. 
Rousse... prenom : Guy... mail : guitou@poulet.com... 
Barthes... prenom : Fabien... mail : fabi@loos.org... 



Dans le cas particulier ou la requete de selection porte sur une seule colonne d'un table, 
comme la recherche des adresses e-mail des utilisateurs dont on connait le departement, 
la methode fetchSingleO est plus rapide que les precedentes. A chaque appel elle 
retourne la valeur de la premiere colonne specifiee dans la requete SQL sous la forme 
d'une chaine de caracteres. 

L'exemple 18-21 realise avec cette methode une lecture similaire a celle de l'exemple 
18-7 avec la fonction sql ite_fetch_single( ). La requete SQL selectionne les e-mails des 
personnes habitant le departement de code 13 (repere ©). Apres l'envoi de la requete 
avec la methode query () (repere©), la variable $result represente un objet de type 
SQLiteResult auquel vous appliquez la methode fetchSingleO. Cette derniere retourne la 
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variable $mai 1 contenant l'information recherchee, qui est ensuite affichee (repere ©). Si 
vous ne vous interessez qu'a la premiere valeur, la boucle while est inutile, et vous 
pouvez ecrire simplement le code suivant : 

ISmai 1 =$resul t->f etchSi ngl e( ) ; 
echo "<h4>Mail : $mail </h4>"; 

Cela peut etre utile pour une requete dont vous savez par avance qu'elle ne retourne 
qu'une seule ligne, comme la recherche du nom d'un utilisateur dont vous connaissez 
ridentiflant unique. 

Exemple 18-21. Lecture d'une seule colonne 

<?php 

if ($db=new SQLiteDatabase("C:/wamp/apps/sql itemanagerl.2.0/sportifs") ) 

{ 

$requete = "SELECT mail FROM personne WHERE depart='13"' ; <— Q 

if($result=$db->Query($requete)) <— © 

{ 
while($mail=$result->fetchSingle()) echo "<h4>Mail : $mail </h4>";<^@ 

} 
} 

else echo $erreur ; 
?> 

Pour lire une colonne precise dans la ligne en cours d'un resultat, vous disposez de la 
methode col umn(), qui s'applique a l'objet $result et dont la syntaxe est la suivante : 

divers $result->col umntstring nom_col | integer num_col ) 

L'unique parametre precise le nom de la colonne ou de son alias avec une chaine ou sa 
position dans la requete SQL avec un entier, la premiere colonne ayant le numero 0. 

Si la requete est : 

$requete="SELECT nom, prenom, mail AS adresse_mail FROM personne"; 
le code suivant : 

$mail=$resul t->column( 'adresse_mail ' ) ; 
ou encore : 

$mail=$result->coluvvmn(2) ; 
permet de ne lire que la colonne des adresses e-mail. 

Informations sur le resultat 

A partir d'un objet SQLiteResult, vous pouvez obtenir des informations sur les donnees 
retournees par la requete SQL. La methode suivante : 

string $result->fieldName(integer N) 
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retourne le nom, ou 1' alias, de la colonne situee a la position N dans la requete. Elle peut 
servir a realiser un affichage dynamique du nom de la colonne quand il n'est pas connu a 
l'avance. 

De meme, pour obtenir le nombre de colonnes d'un resultat, vous pouvez appeler la 
methode numFields( ) avec le code suivant : 

$nbcol=$result->numFields( ) ; 

qui peut servir a realiser une boucle de lecture des resultats. 

Le nombre de lignes retourne dans l'objet SQLiteResult peut etre lu au moyen de la 
methode numRows( ) selon le code suivant : 

$nbl igne=$resul t->numRows( ) ; 

Ce nombre peut egalement servir a creer une boucle for de lecture de toutes les lignes. 



Lecture dans un objet 

Methode objet oblige, il est possible de recuperer les donnees issues d'une requete de 
selection dans un objet. II faut pour cela appeler la methode fetchObject( ) pour l'objet 
$result retourne par une des methodes d'envoi de requete. L'objet obtenu a autant de 
proprietes que la requete SQL contient de noms de colonnes. A chaque appel, l'objet 
retourne contient la ligne suivante du resultat. 

L'exemple 18-22 realise au moyen de cette methode la meme operation que l'exem- 
ple 18-11, qui utilisait la fonction sqlite_fetch_object(). La requete SQL selectionne les 
coordonnees de toutes les personnes inscrites dans la table personne (repere Q). Apres 
l'envoi de la requete par la methode queryO et la recuperation du resultat dans l'objet 
$resul t (repere @), la variable $db est detruite. La lecture des lignes de resultats dans un 
objet est faite par une boucle whi 1 e, qui appelle la methode fetchObjectO. 

La lecture de chacune des proprietes de l'objet $obj obtenu est faite par une boucle 
foreach (repere 0). L'objet Sresult peut ensuite etre detruit pour liberer la memoire. 
Cela n'est utile que si le script contient une suite importante d' instructions (repere ©). 

<** Exemple 18-22. Lecture a I'aide d'un objet 

<?php 

if ($db=new SQLiteDatabase("C:/wamp/apps/sql itemanagerl.2.0/sportifs" , 0666, 

*»$erreur)) 

{ 

Srequete = "SELECT nom, prenom, mail AS 'adresse_mail ' FROM personne" ; <— O 

if (Sresult = $db->query (Srequete) ) <— © 

{ 

$nb=$result->numRows() ; 

unset($db); <— © 

echo "<h3>Liste des $nb personnes enregistrees</h3>" ; 

while($obj=$result->fetchObject()) 

{ 
echo "<p>"; 
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foreach($obj as $prop=>$valeur) <— Q 
{ 

echo "$prop : <b> Svaleur </b>"; 
} 

echo "</p>"; 
} 

unset(Sresult) ; <— Q 
} 

else echo " La requete n'a pas aboutie" ; 
} 

else echo Serreur ; 
?> 

Le resultat affiche par ce script est de la forme suivante : 



Liste des 11 personnes enregistrees 

nom : Cissai prenom : Gabril adressejail : gabril@qsdfg.com 

nom : Dupont prenom : Mack adressejail : azertyu@sdfg 

nom : Valmont prenom : Paul adresse_mail : paul@comte.net 



Creation de fonctions SQL personnalisees 

Comme vous l'avez deja realise avec la methode procedurale, il est possible avec la 
methode objet de creer des fonctions SQL personnalisees utilisables dans des requetes. 
Vous devez pour cela suivre les memes etapes, a savoir la creation d'une fonction person- 
nalisee puis son enregistrement au moyen de la methode createFunctionO de l'objet 
SQLiteDatabase, qui doit respecter la syntaxe suivante : 

boolean createFunctiontstring nom_sql , string nom_php, integer nb) 

Le parametre nom_sql est le nom par lequel la fonction personnalisee est appelee dans le 
code SQL. Le parametre nom_php designe le nom de la fonction dans le code PHP, et nb le 
nombre de ses parametres. 

L'exemple 18-23 adapte a la methode objet l'application de l'exemple 18-13, qui utilisait 
la methode procedurale. Vous creez d'abord la fonction personnalisee present (repere ©), 
qui retourne une chaine dont l'initiale est en majuscules et les autres lettres en minuscu- 
les. Elle est enregistree par SQLite sous le nom initiale en appelant la methode 
createFunctionO (repere ©) puis utilisee dans une requete SQL (repere ©). L'affichage 
des resultats retourne par la methode fetch ( ) (repere ©) est ensuite realise en utilisant 
les indices du tableau $1 i gne (repere ©) puis les cles de ce tableau (repere ©). 



Attention 

Pour utiliser les cles du tableau $1 i gnes, vous devez imperativement definir des alias, qui seront les cles 
de ce tableau pour les colonnes auxquelles vous appliquez des fonctions personnalisees ou des fonctions 
PHP. Sans cela, vous n'obtenez aucun resultat. Cela n'est pas necessaire si vous utilisez seulement les 
indices. 
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Exemple 18-23. Creation de fonctions SQL person nalisees 

<?php 

function present($mot) <— O 



{ 

return ucfirst(strtolower($mot) ) ; 
} 

if ($db=new SQLiteDatabase("C:/wamp/apps/sqlitemanagerl.2.0/sportifs" , 0666, 
*»$erreur) ) 
{ 
$db->createFunction( 'initiale' , 'present' ,1) ; <— © 
Srequete = "SELECT upper(nom) AS nom, initiale(prenom) AS prenom, 
*»php( 'strtolower' .mail ) AS mail FROM personne" ; <— © 
if (Sresult - $db->query ($requete)) 
{ 
echo "<h3>l_iste des personnes enregistrees</h3>" ; 
while($ligne=$result->fetch(SQLITE_BOTH)) 
{ 
echo "Nom : ", $ligne[0] ," Prenom : ", $ligne[l] , " Mail : ", $ligne[2], 
*"<br />"; <-© 

echo "Nom : ", $1 igne[ 'nom' ] ," Prenom : ", $1 igne[ 'prenom' ] , " Mail : ", 
*-$ligne['mail'] ,"<br />";<—© 
} 
} 

else echo " La requete n'a pas aboutie" ; 
unset($db) ; 
} 

else echo $erreur ; 
?> 



Lobjet SQLiteException 

Vous avez deja rencontre la classe Exception, qui permet la gestion des exceptions surve- 
nant dans un script (voir le chapitre 3). SQLite dispose d'une classe speciale, nommee 
SQLiteException, derivee de la precedente. Elles possedent toutes deux les memes 
proprietes et les memes methodes. II n'y a done rien de nouveau dans l'utilisation de 
cette classe par rapport a ce que vous avez deja realise. 

Pour illustrer l'emploi d'un objet SQLiteException lors d'un acces a la base sportifs, le 
code de l'exemple 18-24 tente d'acceder a une table qui n'existe pas (elle est appelee 
personnes alors que seule la table personne a ete creee). Pour masquer les messages 
d'erreur a l'utilisateur, vous appelez la fonction error_reporti ng( ), qui bloque l'affichage 
de tous ces messages (repere ©). L'ensemble du code de lecture de la table est inclus 
dans un bloc try (repere ©). 

Comme l'envoi de la requete par la methode query ( ) retourne la valeur FALSE (repere ©), un 
message est affiche, et une exception est declenchee par l'instruction throw. Cette 
derniere provoque la creation d'un objet de type SQLiteException. Vous attribuez a cet 
objet un texte de message d'erreur et un code d'erreur, qui correspondent respectivement 
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aux proprietes message et code de l'objet, en passant ces deux parametres a son constructeur 
(repere ©). 

En cas d'erreur, l'exception est geree par le bloc catch (repere 0). Ce dernier provo- 
que l'affichage successif du message d'erreur, en utilisant la methode getMessageO 
(repere©), du code d'erreur que vous avez defini en appelant la methode getCodeO 
(repere©) et de la ligne a laquelle l'exception a ete creee en appelant la methode 
getl_ine( ) (repere @). 

Ces informations, surtout utiles aux programmeurs, sont genantes pour les visiteurs du 
site. Dans la pratique, vous vous dispenseriez de les afficher en detail et vous contente- 
riez de les envoyer, par exemple, par e-mail au webmestre du site. A 1' inverse, il peut etre 
utile de rendre visible a l'utilisateur un message plus presentable sous la forme d'une 
boite d'alerte creee avec la fonction JavaScript alertt ) que vous connaissez bien. Vous 
realisez cela dans le bloc catch en creant un element XHTML <script> (repere ©). 

Exemple 18-24. Gestion des exceptions SQLite 

<?php 

// Suppression des avis d'erreurs 
error_reporting(0) ; <— O 
try <^© 
{ 
if ($db=new SQLiteDat abase ("C:/wamp/apps/sql itemanagerl.2.0/sportifs") ) 
{ 
Srequete = "SELECT mail FROM personnes WHERE depart='13"' ; 
if( !$result=$db->query( Srequete)) <— © 
{ 
echo "<h2>ERREUR SQLITE</h2>" ; 

throw new SQLiteExceptionC'Erreur de requete SQLite" ,67) ; <— © 
} 

else 
{ 

while($mail=$result->fetchSingle()) echo "<h4>Mail : Smail </h4>"; 
} 
} 
} 

catch(SQLiteException $myexcept) <— © 
{ 
echo "<h2>MESSAGE : " ,$myexcept->getMessage( ) , "</h2>" ; <— © 
echo "<h2>C0DE : " ,$myexcept->getCode( ) ,"</h2>" ; <^© 
echo "<h2>LIGNE : " ,$myexcept->getLine( ) , "</h2>" ; <^@ 
echo "<script> alert( 'Desole! ERREUR SQLite Numero : ", 
**$myexcept->getCode( ) ," ' )</script> " ; <— © 
} 
?> 

Le resultat affiche par ce script est illustre a la figure 18-6. 
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Figure 18-6 

Resultat obtenu en cas d'erreur 



Acces a SQLite avec PDO 

II est egalement possible d'acceder a une base SQLite au moyen de PDO, comme nous 
l'avons fait au chapitre 17 pour MySQL. II faut, pour cela, realiser la connexion en creant 
un objet PDO au moyen de son constructeur selon la syntaxe : 

$db=new PD0( "sql ite2:C:/wamp2/apps/sql itemanagerl.2.0/sportifs") 

Cette ligne de code permet d'acceder a notre base sportifs creee precedemment. Pour 
une base SQLite 3, il faudra ecrire sql ite3 en debut de chaine de connexion. L'objet $db 
obtenu represente la connexion de la meme facon que dans les sections ci-dessus. Toutes 
les methodes des objets PDO etudiees au chapitre 17 sont egalement utilisables pour 
gerer la base SQLite et nous ne les detaillerons pas ici. L'exemple 18-25 illustre une 
connexion realisee avec PDO (repere Q)> suivie de l'envoi au serveur d'une requete de 
selection au moyen de la methode queryO (repere ©), puis de la lecture des lignes 
de resultat a l'aide de la methode fetch ( ) (repere ©). Hormis la chaine de connexion a la 
base, ecrite dans le constructeur de l'objet PDO, vous pouvez constater qu'il n'y a rien de 
neuf ici, et c'est tout l'interet de PDO, le meme script pouvant etre reutilise pour des 
bases de type tres different au prix d'une modification mineure. 

<*" Exemple 18-25 Connexion avec PDO 

<?php 

if ($db=new PDOC "sql ite2:C:/wamp2/apps/sql itemanagerl.2.0/sportifs") ) <— © 



( 



Srequete = "SELECT id_personne as 'Numero', nom as 'Norn', prenom as 'Prenom', 

*»iTiail FROM personne" ; 

if ($result=$db->query($requete)) <— © 
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unset($db); 

//Lecture des resultats 
echo "<h3>Resultats </h3>"; 

while($tab=$result->fetch(PD0::FETCH_ASS0O) <-© 
{ 
foreach($tab as $cle=>$valeur) 
{ 

echo $cle," :    " ,$valeur , "   ; 
} 

echo "<br />" ; 
} 
} 

else echo " La requete n'a pas aboutie" ; 
} 

else echo "ERREUR" Jerreur ; 
?> 



Memo des fonctions 

array sql ite_array_query (resource $id_base, string $requete [, i tit tab_type]) 

Envoie une requete a la base et retourne un tableau contenant toutes les lignes du resultat. 

void sql ite_busy_timeout (resource $id_base, int N) 

Fixe le delai d'attente a N milliseconde quand la base est verrouillee par un autre acces. 

int sql ite_changes (resource $id_base) 

Retourne le nombre de lignes modifiees par la derniere requete SQL. 

void sqlite_close (resource $id_base) 

Ferme la base pour I'acces identifie par $id_base. 

mixed mixed sql ite_col umn (resource $result, mixed num|nom) 

Retourne le contenu d'une colonne identifiee par son nom ou son numero dans la ligne en cours. 

bool sql ite_create_f unction (resource $id_base, string nom_sql , string nom_php [, int nb_param]) 

Enregistre la fonction nom_php pour pouvoir I'utiliser dans une requete SQL sous le nom nom_sql . 

array sql ite_current (resource $result [, int tab_type]) 

Retourne la ligne en cours dans un tableau dont le type depend de la constante tab_type, laquelle prend les valeurs 
SQLITE_BOTH, SQLITE_NUM ou SQLITE_ASSOC. 

string sql ite_error_string (int N) 

Retourne le dernier message d'erreur. 

string sql ite_escape_string (string $ch) 

Ajoute le caractere d'echappement devant les caracteres speciaux des chaines a inserer dans la base. 

boolean sql ite_exec( resource $id_base, string $requete) 

Envoie une requete a la base. Utilisable seulement pour les requetes ne retournant pas de resultat. 
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array sql ite_fetch_all (resource $result[, integer tab_type]) 

Retourne I'ensemble des lignes du resultat dans un seul tableau multidimensionnel. 

array sql 1 te_fetch_array ( resource $result [, int tab_type]) 

Retourne la ligne en cours du resultat dans un tableau dont le type est determine par la constante tab_type. 

object sql ite_fetch_object( resource Sresult) 

Retourne la ligne en cours du resultat dans un objet dont les proprietes ont pour noms ceux des colonnes selectionnees 
dans la requete. 

string sql ite_fetch_single (resource $result) 

Retourne la premiere colonne du resultat dans une chaine. 

string sql ite_field_name (resource $result, int numcol ) 

Retourne le nom de la colonne placee a la position numcol dans la requete. 

bool sql i te_has_more (resource $result) 

Indique s'il reste encore des lignes non lues dans le resultat. 

int sql ite_last_error (resource $id_base) 

Retourne le dernier code d'erreur. 

int sql ite_l ast_insert_rowid (resource $id_base) 

Retourne la derniere valeur inseree dans une cle primaire auto-incrementee. 

string sql ite_l ibencoding (void ) 

Retourne le nom du jeu de caracteres utilise par SQLite (par exemple ISO 8859). 

string sql ite_l ibversion (void ) 

Retourne le numero de version de SQLite. 

bool sqlite_next (resource $result) 

Place le pointeur de resultat sur la ligne suivante. 

int sql ite_num_fi elds (resource $result) 

Retourne le nombre de colonnes du resultat. 

int sql ite_num_rows (resource $result) 

Retourne le nombre de lignes du resultat. 

resource sqlite_open (string nom_base [, int mode [, string Serreur]]) 

Ouvre la base nommee nomjoase. Ce parametre peut etre un chemin d'acces complet. Retourne un identifiant de 
connexion, ou FALSE en cas d'erreur. 

resource sqlite_popen (string filename [, int mode [, string $erreur]]) 

Ouvre une connexion persistante a la base. Retourne un identifiant de connexion, ou FALSE en cas d'erreur. 

resource sqlite_query (resource $id_base, string $requete) 

Envoie une requete a la base identified par $id_base et retourne un identifiant de resultat, ou FALSE en cas d'erreur. 

bool sqlite_rewind (resource result) 

Replace le pointeur de resultat a la premiere ligne. 



La base SQLite 

Chapitre 18 



bool sqlite_seek (resource result, int N) 

Place le pointeur de resultat a la ligne N. 

resource sql 1 te_unbuffered_query (resource $id_base, string $requete) 

Envoie une requete a la base et retourne un identifiant de resultat, ou FALSE en cas d'erreur. Le resultat n'est pas mis en 
buffer et doit etre utilise avant I'envoi de toute autre requete. 

Memo des methodes des objets 

Dans la syntaxe des methodes ci-dessous, la variable $db designe un objet SQLiteDatabase 
et la variable $result un objet SQLiteResult ou SQLiteUnbuffered. 

array $db->arrayQuery(string $requete, integer tab_type) 

Envoie une requete a la base et retourne un tableau contenant toutes les lignes du resultat. Le parametre tab_type deter- 
mine le type du tableau. II prend les valeurs SQLITE_BOTH, SQLITE_NUM ou SQLITE_ASSOC. 

void $db->busy_timeout(integer N) 

Fixe le delai d'attente admissible a N milliseconde. 

integer $db->changes( ) 

Retourne le nombre de lignes modifiees dans la base par la derniere requete. 

divers $resul t->col umntinteger numcol | string nomcol ) 

Retourne le contenu de la colonne indiquee par son indice ou par son nom dans la ligne en cours du resultat. 

boolean $db->createFunction(string nom_sql , string nom_php [.integer N]) 

Enregistre la fonction personnalisee nom_php sous le nom nom_sql pour pouvoir I'utiliser dans des requetes SQL. 
N designe le nombre de parametre de la fonction nom_php. 

array $result->current(integer tab_type) 

Retourne la ligne en cours dans un tableau dont le type est precise par tab_type. 

array $result->fetch(integer tab_type) 

Retourne la ligne en cours dans un tableau indice ou associatif selon la valeur de tab_type. 

array $result->fetchAl 1 (integer tab_type) 



Retourne toutes les lignes du resultat dans un tableau multidimensionnel indice ou associatif selon la valeur de tab_ 
type. 

object $resul t->fetchObject( ) 

Retourne la ligne en cours dans un objet dont les proprietes ont pour noms ceux des colonnes presentes dans la requete. 

string $resul t->fecthSingle( ) 

Retourne la valeur de la premiere colonne de la ligne en cours du resultat. 

string $resul t->fieldName(integer N) 

Retourne le nom de la colonne d'indice N dans le resultat. 

boolean $resul t->hasPrev( ) 

Retourne TRUE s'il existe une ligne precedente dans le resultat et FALSE dans le cas contraire. 
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integer $db->last_error( ) 

Retourne le code de la derniere erreur. 

integer $db->last_insert_rowid( ) 

Retourne la derniere valeur entiere inseree dans une colonne auto-incrementee. 

boolean $resul t->next( ) 

Place le pointeur de resultat sur la ligne suivante. Retourne TRUE si elle existe et FALSE dans le cas contraire. 

integer $resul t->numFields( ) 

Retourne le nombre de colonnes presentes dans le resultat. 

integer $resul t->numRows( ) 

Retourne le nombre de lignes presentes dans le resultat. 

object $db->query(string $requete) 

Envoie une requete a la base $db et retourne un objet SQLiteResult. 

boolean $db->queryExec(string $requete) 

Envoie une requete ne retournant pas de resultat a la base $db et retourne TRUE ou FALSE. 

boolean $resul t->rewind( ) 

Replace le pointeur de resultat a la premiere ligne. Retourne TRUE si I'operation a reussi et FALSE dans le cas contraire. 

boolean $resul t->seek(integer N) 

Place le pointeur de resultat a la nieme ligne. Retourne TRUE si I'operation a reussi et FALSE dans le cas contraire. 

string | integer $db->singleQuery(string $requete) 

Envoie une requete a la base $db et retourne la valeur de la premiere colonne de la ligne en cours. 

object $db->unbufferedQuery(string $requete) 

Envoie une requete a la base $db et retourne un objet SQLiteUnbuffered. 

Pour les methodes des objets PDO vous pouvez vous referer au memo du chapitre 17. 



Exercices 



Le but de ces exercices est de realiser avec SQLite la meme application que celle realisee 
avec MySQL au cours des exercices des chapitres 13 et 14. 

Exercice 1 

Creez une base nominee voitures a l'aide de SQLiteManager. Creez ensuite les tables 
de la base voitures selon le modele logique defini dans les exercices du chapitre 13 (en 
cas de probleme, voir le corrige des exercices de ce chapitre). Verifiez la structure de 
chaque table. 
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Exercice 2 

Creez un formulaire permettant l'insertion des coordonnees d'une personne dans la table 
propretai re en utilisant la methode objet. 

Exercice 3 

Inserez des donnees dans la table model e en utilisant SQLiteManager, puis creez un script 
qui affiche la liste de tous les modeles de voiture dans un tableau XHTML en effectuant 
un tri par marque. Utilisez la methode procedurale. 

Exercice 4 

Adaptez le script de l'exercice 3 en utilisant la methode objet. Les donnees de chaque 
ligne du resultat doivent aussi etre retournees sous forme d'objet. 

Exercice 5 

Creez dynamiquement un formulaire contenant une liste de selection XHTML (avec les 
elements <select> et <option>) qui donne la liste de tous les modeles presents dans la 
table model e. Ajoutez manuellement a l'aide de SQLiteManager un ou plusieurs modeles a 
la table, et verifiez que la liste de selection prend bien en compte ces ajouts. Utilisez 
successivement la methode procedurale et la methode objet. 

Exercice 6 

Utilisez le mecanisme des transactions pour inserer simultanement et en toute securite 
des donnees dans les tables proprietaire et cartegrise. Utilisez la methode procedurale 
puis la methode objet. 

Exercice 7 

Creez un formulaire de recherche permettant de trouver toutes les personnes proprietai- 
res d'un modele de vehicule donne. Affichez les resultats sous forme de tableau 
XHTML. Utilisez l'exercice 5 pour creer la liste de selection des modeles. 

Exercice 8 

Reprendre les exercices precedents et les reecrire en utilisant systematiquement des objets 
PDO. 
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PHP et SimpleXML 



L'extension SimpleXML fut une des nouveautes importantes de PHP 5. Cette nouveaute 
n'est pas vraiment revolutionnaire puisque l'extension DOMXML permettait deja d'acce- 
der au contenu d'un fichier XML a partir d'un script PHP. 

A la difference de DOMXML, SimpleXML apporte, comme son nom l'indique, un acces 
facile a toutes sortes de documents XML, meme s'ils ont une structure complexe. Elle est 
encore dotee de peu de fonctions, mais elle ne tardera pas a s'enrichir au fur et a mesure 
des besoins manifestos par ses utilisateurs et la version 3 a deja accru le nombre de 
commandes SQL disponibles. 

Les fonctions de SimpleXML retournent des objets qui possedent des methodes interes- 
santes d'analyse des fichiers. Les fonctions et methodes disponibles permettent de lire et 
de modifier le contenu des elements ou des attributs d'un fichier XML, de sauvegarder 
ces modifications et d'effectuer des recherches sur les contenus. Cela represente deja un 
large eventail d'activites. 

Notions de XML 

Le langage XML (extensible Markup Language) est un vecteur privilegie d'echange de 
donnees entre applications differentes. Comme l'illustre la figure 19-1, XML peut etre 
le point commun d' applications qui ne pourraient pas communiquer entre elles sans son 
intermediaire. 

A l'instar du XHTML, XML est un langage de structuration de contenu au moyen de 
balises. 
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Figure 19-1 

XML est un format d'echange entre applications 

Pour delimiter des elements ayant un contenu explicite, XML utilise les structures gene- 
rales suivantes : 

<balise> contenu de 1 'element </balise> 

Pour les elements n'ayant pas de contenu explicite (elements vides), dans lesquels 
1' information est donnee uniquement dans un ou plusieurs attributs, il utilise les balises 
suivantes : 

<balise attribut = "valeur"/> 

En XHTML, il existe 70 elements predetermines. Les navigateurs implementent ces 
elements et associent a chacun d'eux un type de presentation de leur contenu. 

Par exemple, les lignes suivantes : 

<hl> PHP5 MySQL </hl> 

ecrivent dans un navigateur un gros titre suivi d'un saut de ligne, mais cette presentation 
peut etre modifiee avec l'emploi de feuilles de styles CSS. 



DTD (Document Type Definition) 

Une DTD contient la description des elements admis dans un document XHTML ou XML, comme le type 
d'un contenu et ses attributs. Pour etre conforme, le document doit respecter ces definitions. Par exemple, 
I'element <html > ne peut avoir comme elements fils que les elements <head> et <body> et comme attri- 
buts que xml ns, 1 ang et di r. 



L'objectif de XML est different. II consiste a decrire un grand nombre de types d'infor- 
mations differents, allant de la description des coordonnees d'un client jusqu'a celle 
d'une base de donnees complete, ce que ne permet pas le XHTML. 

L'idee essentielle a Porigine de XML est de structurer Pinformation en separant le 
contenu de sa presentation, que ce soit dans un navigateur ou dans des medias les plus 
divers. Le contenu est ecrit dans un fichier XML, et la presentation dans une feuille de 
style CSS ou XSLT. 
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Pour ecrire un document XML, vous n'etes plus limits par un nombre d'elements fixe. 
Le createur d'un document peut meme choisir les noms des elements qu'il souhaite utili- 
ser pour structurer ses informations. 

L'ecriture d'un document XML doit obeir a des regies syntaxiques strides afin d'etre 
bien forme et lisible par un parseur XML, celui d'un navigateur pour ce qui nous 
concerne. 

Les principales regies syntaxiques de XML sont les suivantes : 

• Chaque document commence par l'element suivant : 

<? xml version = "1.0" encoding="IS0-8859-l" standalone = "yes"> 

dans lequel l'attribut version definit la version de XML utilisee. La derniere version 
publiee par le W3C est la 1.1, mais elle n'est actuellement pas bien reconnue par tous 
les navigateurs. L'attribut encoding contient le jeu de caracteres utilise dans le docu- 
ment. L'attribut standalone indique si le document est independant (valeur "yes") ou 
s'il doit faire appel a un autre document externe, comme une DTD, pour pouvoir etre 
utilise (valeur "no"). 

• Chaque document doit avoir un element racine qui englobe tous les autres. C'est 
l'equivalent de l'element <html > </html > dans un document XHTML. 

• Les noms des elements sont ecrits le plus souvent en minuscules. Les majuscules sont 
cependant autorisees, a condition que la balise d'ouverture ait la meme casse que celle 
de fermeture. 

• Chaque element ayant un contenu doit avoir une balise d'ouverture et une balise de 
fermeture, comme en XHTML selon la forme : 

| <element> contenu </element> 

• Les elements n'ayant pas de contenu peuvent avoir la forme suivante : 

<element /> 

• Chaque element peut en contenir d' autres, sans limite de nombre. Les elements qui en 
contiennent d'autres doivent etre fermes apres tous ceux qu'ils contiennent. On dit 
qu'ils doivent etre correctement emboites. Leur structure doit respecter la forme gene- 
rale suivante : 

<element> 

<souselement> 
contenu du sous element 

</souselement> 
</element> 

Vous obtenez une hierarchie pere-fils selon le modele presente a la figure 19-2. 

Tous les elements peuvent avoir des attributs contenus dans la balise d'ouverture. Les 
valeurs de ces attributs doivent etre ecrites entre guillemets : 

<element attribut="valeur">contenu </element> 
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Les caracteres speciaux suivants presents dans le contenu d'un element doivent etre 
remplaces par des entites predefinies : 



<' 


par 


'&lt:' 


>' 


par 


'>' 


&' 


par 


'& ' 


" 


par 


'" 


' 


par 


'&apos; 



La structure type d'un document XML est la suivante : 

<?xml version="1.0" encoding="iso-8859-l" standalone="yes"?> 
<racine > 
<elementl attribut="valeur"> 
<souselementA attribut="valeur">contenu A</souselementA> 
<souselementB attribut="valeur">contenu B</souselementB> 
</elementl> 

<element2 attribut="valeur"> 
<souselementC attribut="valeur">contenu C</souselementC> 
<souselementD attribut="valeur">contenu D</souselementD> 
</element2> 
</racine> 

En consequence de la regie d'emboitement des elements, un document a une structure 
arborescente, comme illustre a la figure 19-2. 




Figure 19-2 

Structure arborescente d'un fichier XML 



Si vous ouvrez ce fichier dans un navigateur Firefox, vous obtenez un affichage sans 
grand interet pratique, comme le montre la figure 19-3. 

Dans le navigateur Amaya cree par le W3C, vous obtenez 1' affichage du contenu des 
elements sans les balises qui les delimitent ni leurs attributs, comme l'illustre la 
figure 19-4. 

Pour exploiter le contenu d'un fichier XML dans une page Web, il vous faut envisager les 
moyens de lire un fichier XML et de recuperer le contenu de ses elements dans des varia- 
bles utilisables par des scripts PHP. 
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Ce fichier XML ne semble pas avoir d'information de style associe avec bi. L'arbre du document est 
montre ci-dessous. 



-<racine> 

— <elemeatl attribut="valeur"> 

<souseleuieatA attribute" valeur">contenu A</souselementA> 
<souselemeutB attribute" valeur">contenu B< ; souselementB> 
</elemeDtl> 

— <elemeat2 attribut="valeur"> 

<souselementC attribute" valeur">contenu C< ; souselementC> 
<souselementD attribute" valeur">contenu D< ; souselementD> 
<eletnent2> 
<'racine> 



Figure 19-3 

Visualisation du fichier dans Firefox 




Figure 19-4 

Visualisation du fichier dans Amaya 

Lecture d'un fichier XML 

L'extension SimpleXML fournit des fonctions qui permettent un acces simple et rapide 
au contenu d'un fichier XML a l'aide d'objets de type simplexml_element. Ces objets 
comportent des proprietes et des methodes qui permettent d' acceder au contenu des 
elements, de le modifier ou d'effectuer des recherches dans le fichier. 



Acceder au contenu d'un fichier XML 

Pour acceder au contenu d'un fichier XML, vous disposez de la fonction simpl exml_l oad_ 
fileO. 
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Cette fonction transfere le contenu du fichier dans un objet de type simpl exml„el ement 
contenant l'arborescence du fichier. Les proprietes de cet objet prennent pour noms ceux 
de chacun des elements XML et pour valeurs les contenus des elements du fichier. 

La syntaxe de simpl exml_el ement est la suivante : 

object simpl exml_load_file (string nom_fichier) 

Si l'ensemble du code XML est contenu dans une chaine de caracteres $code, vous 
pouvez utiliser la fonction suivante a la place de la precedente : 

object simplexml_load_string (string $code) 

Cette fonction retourne le meme type d'objet. 

Un script de lecture de fichier XML commence done par le code suivant : 

$xml = simpl exml_load_file ("nom_fichier.xml ") ; 

II est suivi de la lecture des donnees du fichier XML au moyen des proprietes et des 
methodes de l'objet $xml de type simpl exml_el ement ainsi obtenu. 

Pour lire le contenu d'un element nomme, par exemple, <1 ivre> vous ecrivez : 

echo $xml->l ivre; 

Le fichier XML bib! iol .xml suivant contient une bibliographie dont l'element racine est 
<biblio> et dont les elements <titre>, <auteur> et <date> contiennent les caracteristiques 
d'un seul livre. 

Le fichier bibliol.xml 

<?xml version="1.0" encoding="iso-8859-l"?> 
<biblio> 

<titre>L'empire de la honte</titre> 

<auteur>Jean Ziegler</auteur> 

<date>2005</date> 
</biblio> 

Le script de l'exemple 19-1 permet de lire le contenu du fichier bibliol.xml. Apres 
le chargement du contenu du fichier dans l'objet $xml (repere ©), l e script affiche le 
contenu de chacun des elements en utilisant les proprietes titre, auteur et date de l'objet 
$xml (reperes ©, © et ©). 

Exemple 19-1. Lecture des elements 

<?php 

$xml=simplexml_load_file( "bibl iol .xml " ) ; <— © 

echo "Titre : " ,$xml ->titre, "<br />"<—©; 

echo "Auteur : " ,$xml->auteur, "<br />"<—©; 

echo "Date : " ,$xml ->date, "<br />"<—©; 

?> 
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L'exemple retourne le resultat suivant : 



Titre : L'empire de la honte 
Auteur : Jean Ziegler 
Date :2005 



Ce premier fichier bibliol.xml esttres simple etn'a pour but que d'introduire lamethode 
de lecture des elements. Vous allez maintenant aborder la methode de lecture d'un fichier 
XML plus proche d'un fichier reel. 

Le fichier bibl io2.xml contient encore une bibliographie, mais il est maintenant capable 
de contenir un nombre quelconque de livres. Pour cela, sa structure a ete modifiee. 
L'element racine <biblio> contient autant d'elements <livre> que necessaire, chaque 
livre etant encore caracterise par les sous-elements <titre>, <auteur> et <date>. 

Le fichier biblio2.xml 

<?xml version="1.0" encoding="iso-8859-l"?> 
<biblio> 
<1 ivre> 

<titre>L'empire de la honte</titre> 
<auteur>Jean Ziegler</auteur> 
<date>2005</date> 
</l ivre> 
<1 ivre> 
<titre>Ritournel le de la faim </titre> 
<auteur>J.M.G Le Clezio</auteur> 
<date>2008</date> 
</l ivre> 
<1 ivre> 
<titre>Singue Sabour : La pierre de patience</titre> 
<auteur>Atiq Rahimi</auteur> 
<date>2008</date> 
</l ivre> 
</biblio> 

Pour acceder au contenu d'un element <1 ivre>, vous devez utiliser une syntaxe proche de 
celle des tableaux. La variable $xml ->1 i vre[0] est maintenant un objet de type simpl exml_ 
element. Cet objet represente le premier livre du fichier et possede autant de proprietes 
que l'element <1 ivre> a de sous-elements. 

Vous accedez aux informations utiles en ecrivant le code suivant : 

echo $xml ->1 ivre[0]->titre; 
echo $xml ->1 ivre[0]->auteur; 
echo $xml ->1 ivre[0]->date; 

Ce code affiche le titre, 1' auteur et la date de publication du premier livre. Pour lire 
l'ensemble des livres, il est preferable d'effectuer une boucle. 
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Le script de l'exemple 19-2 commence par charger le fichier bibl io2.xml (repere ©). II 
lit ensuite 1' ensemble du fichier avec le minimum de code en effectuant une boucle 
foreach sur l'objet $xml->livre (repere©). La variable $cle contient la meme valeur 
livre a chaque iteration. La variable $val est aussi un objet de type simplexml^element, 
dont les proprietes sont titre, auteur et date. Vous y accedez avec la meme syntaxe qu'a 
l'exemple 19-1 (repere ©). L'utilisation du mot-cle static pour la variable compteur $1 
et son incrementation permet d'afficher le numero de chaque livre (reperes © et ©). La 
figure 19-5 illustre le resultat obtenu. 



La fonction countQ 

La fonction get_object_vars($xml ) retourne un tableau de toutes les proprietes de l'objet $xml. En 
appliquant la fonction count ( ) a ce tableau, vous obtenez le nombre de proprietes de l'objet. 



Exemple 19-2. Lecture d'un ensemble d'elements 

<?php 

$xml=simplexml_load_file( "bibl io2.xml " ) ; <— © 
//Lecture du contenu des elements 
foreach($xml->livre as $cle=>$val ) <— © 



( 



static $1=1; <— © 

echo ucfi rst($cle) , " $i : $val->titre de $val->auteur paru en 

*$val->date<hr />"; <-© 

$i++; ^© 



) 
?> 
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Figure 19-5 

Affichage de tons les elements du fichier biblio2.xml 
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Lecture des attributs d'un element 



Chaque element du document XML peut avoir des attributs. Les attributs constituent un 
complement d' information inclus dans un element. Leur definition ressort d'un choix du 
programmeur, car la meme information peut etre enregistree dans un sous-element. Vous 
verrez que la transformation d' une base de donnees en fichier XML par phpMy Admin ne 
cree aucun attribut et cree uniquement des elements. Si ce choix de creer des elements et 
des attributs est fait, il vous faut lire la valeur des differents attributs d'un element. 

Le fichier XML biblio3.xml comporte les memes elements que le fichier biblio2.xnl, 
mais chaque element <1 ivre> a desormais deux attributs, qui precisent l'editeur et le prix 
de chaque livre. 

Le fichier biblio3.xml 

<?xml version="1.0" encoding="iso-8859-l" standalone="yes"?> 
<biblio> 
<livre editeur="FAYARD" prix="20.00"> 

<titre>L' empire de la honte</titre> 

<auteur>Jean Ziegler</auteur> 

<date>2005</date> 
</l ivre> 
<livre editeur="GALLIMARD" prix="18.00"> 

<titre>Ritournel le de la faim </titre> 

<auteur>J.M.G Le Clezio</auteur> 

<date>2008</date> 
</l ivre> 
<livre editeur="POL" prix="15.00"> 

<titre>Singue Sabour : La pierre de patience</titre> 

<auteur>Atiq Rahimi</auteur> 

<date>2008</date> 
</l ivre> 
</biblio> 

Les methodes precedentes ne permettent pas la lecture de ces attributs. Pour parvenir a 
lire ces valeurs, vous disposez des deux possibilites suivantes : 

• Si vous connaissez le nom des attributs, vous pouvez lire leur valeur a l'aide de la 
syntaxe : 

|$xml ->l ivre["editeur"] ; 
$xml ->l ivre["prix"] ; 

• Si vous ne connaissez pas le nom des attributs ou si ces noms sont appeles a changer, 
vous avez interet a abstraire la lecture de leur nom et de la valeur associee en utilisant 
une methode specifique. Chaque objet de type simpl exml_el ement possede en effet une 
methode nominee attributesO, qui retourne elle aussi un objet de meme type. 
Comme precedemment, une boucle f oreach sur cet objet permet de recuperer le nom et 
la valeur de chaque attribut des differents elements <1 ivre>. 
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Le script de l'exemple 19-3 realise a la fois la lecture des elements et celle des attributs. 
Apres l'habituel chargement du fichier XML (repere Q)> une premiere boucle foreach, 
semblable a celle de l'exemple precedent, lit le contenu des elements a l'aide des proprie- 
tes de l'objet $val (repere ©) et les affiche (repere ©). Une seconde boucle foreach 
imbriquee dans la premiere (repere ©) lit et affiche (repere ©) les proprietes de l'objet 
$val en recuperant le nom des attributs dans la variable $att et leur valeur dans la variable 
$valatt. 

Exemple 19-3. Lecture des elements et des attributs 

<?php 

$xml=simplexml_load_file( "bibl io3.xml " ) ; <— O 
//Lecture du contenu des elements 
foreach($xml->livre as $val)<— © 



{ 



echo "<h3>$val->titre de $val->auteur</h3Xb> Paru en $val->date </b> " ; <-© 
//Lecture du nom et du contenu des attributs 
foreach($val->attributes() as $att=>$valatt) <— Q 
{ 

echo "<b> $att : $valatt </b>";<-0 
} 
echo "<hr />"; 



} 

?> 



La mise en forme du contenu obtenue a l'aide d'elements XHTML realise l'affichage 
illustre a la figure 19-6. 
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Figure 19-6 

Affichage des elements et des attributs 



Singue Sabour : La pierre de patience de Atiq Rahimi 
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Lecture d'un fichier a structure complexe 

Les fichiers XML precedents ont tous une structure homogene et ne contiennent que la 
hierarchie suivante repetee autant de fois que la bibliographie contient d'ouvrages : 

<1 i vre> 

<titre> </titre> 

<auteur> </auteur> 

<date> </date> 
</l i vre> 

Si le fichier contient divers elements fils de 1' element racine, ces exemples ne permettent 
plus une lecture aisee du contenu des elements. Le fichier bibl io4.xml presente un type 
de structure complexe contenant un element <ouvrage> (repere O) qui contient des 
elements <livre> comme precedemment. En plus, un element <musique> (repere©) 
contient des elements <disque>, qui contiennent a leur tour des elements <titre>, <auteur> 
et <date>. Chaque grande categorie (ouvrage et musique) est done constituee de trois 
niveaux d'elements imbriques. 

Le fichier biblio4.xml 

<?xml version="1.0" encoding="iso-8859-l" standalone="yes"?> 
<biblio> 
<ouvrage> <— O 
<livre editeur="FAYARD" prix="20.00"> 
<titre>L' empire de la honte</titre> 
<auteur>Jean Ziegler</auteur> 
<date>2005</date> 
</l ivre> 

<livre editeur="GALLIMARD " prix="18.00"> 
<titre>Ritournel le de la faim </titre> 
<auteur>J.M.G Le Clezio</auteur> 
<date>2008</date> 
</l ivre> 

<livre editeur="POL" prix="15.00"> 
<titre>Singue Sabour : La pierre de patience</titre> 
<auteur>Atiq Rahimi</auteur> 
<date>2008</date> 
</l ivre> 
</ouvrage> 
<musique> <— © 
<disque editeur="Deutsche Grammophon" Pri x="14. 00"> 
<titre>5 eme Symphonie </titre> 
<auteur>Ludwig van BEETHOVEN</auteur> 
<date>1808</date> 
</disque> 

<disque editeur="EMI" Prix="14.00"> 
<titre>Suites pour violoncelle </titre> 
<auteur>Johann Sebastian BACH</auteur> 
<date>1725</date> 
</disque> 
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I</musique> 
</biblio> 

Pour lire le contenu de ces deux categories, vous disposez de la methode childrenO de 
l'objet $xml de type simplexml_element retourne par la fonction simplexml_load_file( ) 
de chargement du fichier XML. Chaque fois qu'elle est appliquee, elle retourne un objet 
de type simplexml_element contenant tous les sous-elements de meme niveau situes dans 
le document, et done tous les enfants du noeud precedent. 

Un premier appel (repere O 1 retourne les elements <ouvrage> et <musique>, done tous les 
enfants de l'element racine <biblio>. Un deuxieme appel applique a ces elements 
retourne ceux qu'ils contiennent, et ainsi de suite (reperes Q et ©). 

Sur ce principe, l'exemple 19-4 permet la lecture des trois niveaux de chaque categorie a 
l'aide de trois boucles foreach imbriquees l'une dans l'autre. Le code des deux boucles 
les plus internes est identique. En imbriquant une quatrieme boucle, vous pourriez lire 
quatre niveaux d'elements imbriques. 

Exemple 19-4. Lecture d'une hierarchie d'elements complexe 

<?php 

$xml=simplexml_load_file("bibl io4.xml " ) ; 
foreach($xml->children() as $element=>$val ) <— O 
{ 
echo "<h3>", ucfi rst($element) ,": $val</h3>"; 
foreach($val->children( ) as $e1ement=>$val ) <— © 
{ 
echo " $element : <b>$val</b><br />"; 
foreach($val->children() as $element=>$val ) <— © 
{ 
echo "   Selement : <b>$val</b><br />"; 



) 
?> 

La figure 19-7 illustre le resultat du script de lecture du fichier. 



Modification des valeurs des elements et des attributs 

En utilisant les proprietes de l'objet de type simplexml_element retourne par la fonction 
simpl exml_l oad_f i 1 e( ) , un script peut modifier la valeur du contenu d'un element ou d'un 
attribut. II suffit pour cela d'utiliser la notation objet qui permet de lire une propriete et de 
lui affecter une nouvelle valeur. L'exemple 19-5 realise ces modifications et enregistre le 
fichier modifie sur le serveur. 

Pour modifier, par exemple, les caracteristiques du premier livre du fichier biblio3.xml, 
vous pouvez ecrire le code de l'exemple 19-5. II commence par charger le fichier dans 
l'objet $xml (repere O 1 puis change le titre et la date du premier element <1 ivre> (repe- 
res © et ©) 
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titre : Suites pour violoucelle 

auteur : Johann Sebastian BACH 

date : 1725 



'1 



Figure 19-7 

Lecture du fichier a structure complexe 



A ce stade, les donnees sont censees etre modifiees dans l'objet $xml . Si vous le verifiez 
en effectuant une boucle de lecture (repere ©), vous constatez que le fichier XML n'est 
pas modifie. La raison a cela est que les modifications n'ont pas ete enregistrees. Pour 
enregistrer les modifications, vous appelez la methode asxmlO des objets simplexml_ 
el ement, dont la syntaxe est la suivante : 

string $xml->asxml ([string nom_fichier]) 

Cette methode retourne le contenu de l'objet $xml dans une chaine de caracteres $chxml 
(ou FALSE en cas d'erreur). Utilisee avec comme parametre un nom de fichier (ici 
biblio3a.xml afin de ne pas ecraser l'ancien fichier), la methode enregistre egalement le 
fichier sur le serveur (repere ©). Un controle sur la valeur de la variable $chxml permet 
d'afficher un message de confirmation (repere ©). 
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Exemple 19-5. Modification et enregistrement des donnees 



<?php 

$xml=simplexml_load_file( "bibl io3.xml " ) ; <— O 
//Modification d'un element et d'un attribut 
$xml ->1 ivre[0]->titre="La haine de 1 'Occident 
$xml->livre[0]->date="2008"; <-© 
//Affichage des donnees du fichier 
foreach($xml->livre as $cle=>$val ) <— © 
{ 



^0 



static $i=l; 

echo ucfi rst($cle) , 

$i++; 



$i : $val->titre de $val->auteur paru en $val ->date<hr />" 



//Enregistrement des modifications 
$chxml= $xml ->asxml C"biblio3a.xml " ) ; <— Q 
if($chxml) echo "Enregistrement realise"; <— ® 
?> 

Apres 1' execution du script de 1' exemple 19-5, le premier element <livre> du fichier 
XML est le suivant : 

<livre editeur="FAYARD" prix="20.00"> 

<titre>La haine de 1 'Occident </titre> 

<auteur>Jean Ziegler</auteur> 

<date>2008</date> 
</l ivre> 



Recherche dans un fichier 

L'extension SimpleXML permet d'effectuer des recherches dans un fichier XML grace a 
la methode xpath( ) des objets de type simplexml_element. 

La syntaxe de la methode xpath( ) est la suivante : 

array xpath(string reqjete_xpath) 

La fonction retourne un tableau de tous les contenus d' elements ou d'attributs qui corres- 
pondent a la requete qui lui est passee en parametre. Pour effectuer une recherche, vous 
devez decrire l'arborescence permettant de parvenir a 1' information recherchee. 

Considerant que vous effectuez des recherches de titres, d'auteurs et d'editeurs dans le 
fichier bi bl i o4 . xml , vous pouvez ecrire les exemples de requetes suivants : 

• Pour trouver tous les titres de livre (seuls les elements fils de l'element <1 i vre> ont un 
contenu textuel dans le fichier) : 

|$xml ->xpath("/bibl io/ouvrage/1 ivre/titre") ; 
$xml ->xpath("//ouvrage/l ivre/titre") ; 
$xml->xpath("//l ivre/titre") ; 

• Pour trouver les auteurs, vous remplacez titre par auteur. Faites de meme pour les dates. 
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Pour trouver tous les titres de disque : 

$xml ->xpath("/biblio/musique/disque/titre" ) ; 
$xml ->xpath("//musique/disque/titre") ; 
$xml ->xpath("//disque/titre") ; 

De meme que precedemment, pour trouver tous les compositeurs, vous remplacez 
titre par auteur. Faites de meme pour les dates. 

Pour trouver tous les titres ou les auteurs, qu'ils soient dans la categorie ouvrage ou 
musique, vous ecrivez : 

$xml->xpath( "//titre") ; 
$xml ->xpath( "//auteur" ) ; 

Pour trouver la valeur d'un attribut, vous ecrivez le nom de l'attribut a la place de celui 
de l'element, en le faisant preceder du caractere @. Par exemple, pour trouver tous les 
attributs editeur des elements <1 ivre>, vous ecrivez : 

$xml ->xpath("/biblio/ouvrage/l ivre/@editeur") ; 
$xml ->xpath("//ouvrage/l ivre/@editeur") ; 
$xml ->xpath("//l ivre/@editeur" ) ; 

Pour trouver toutes les valeurs des attributs editeur, qu'ils soient ceux des elements 
<livre> ou <disque>, vous ecrivez : 



$xml->xpath(" //©editeur") ; 



XPath 

XPath est un langage puissant permettant la creation de requetes. Nous ne nous etendons pas ici sur la 
composition des requetes XPath, mais vous pouvez consulter a ce sujet la recommandation du W3C sur 
le site http://www.w3.org/TR/xpath. 



Les resultats de ces recherches etant retournes dans un tableau indice, vous pouvez utili- 
ser une boucle for ou foreach pour les lire. 

L'exemple 19-6 propose une illustration du mecanisme de recherche utilisant la methode 
xpath( ). Le fichier est compose d'une partie XHTML, qui cree le formulaire comprenant 
deux listes de selection nominees choix (repere O) et cat (repere©), avec lesquelles 
l'utilisateur peut choisir respectivement le contenu qu'il desire (titre, auteur ou editeur) et 
la categorie (ouvrage, musique ou les deux a la fois). La valeur associee a chaque option 
servira a composer la chaine de la requete XPath. Ces valeurs sont recuperees par le 
script dans les variables $_P0ST['choix'] et $_P0ST[cat'] (reperes ©et©). 

Apres le chargement du fichier biblio4.xml (repere©), l'objet $xml appelle la methode 
xpathO, dont la chaine de requete est la concatenation de deux variables, $cat et 
$choix, les resultats etant retournes dans le tableau $result (repere ©). L'elimination 
des doublons s'effectue en appliquant la fonction array_unique() au tableau $result 
(repere©). L'utilisation d'une boucle foreach permet l'affichage de tous les resultats 
sous forme de liste ordonnee (repere ©). 
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La figure 19-8 illustre les resultats obtenus apres une recherche de tous les titres de la cate- 
gorie ouvrage, la chaine de requete etant alors la concatenation des chaines //ouvrage/ 
1 ivre/ et titre. 

Exemple 19-6. Recherche dans un fichier XML 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="content-type" content="text/html ; charset=iso-8859-l" /> 
<title>Bibliographie XML</title> 
</head> 
<body> 

<form action= "<?php echo $_SERVER[ ' PHP_SELF' ] ?>" method="post" 

*»enctype="application/x-www-form-url encoded "> 

<fieldset> 

<legend><b>Bibl iographie</b></legend> 

<table><tbody> 

<tr> 

<td>Rechercher tous les : </td> 

<td> 

<select name="choix"> <— O 

<option value="titre">Titre</option> 

<option value="auteur">Auteur</option> 

<option value="@editeur">Editeur</option> 

</select> 

</td> 

<td>Dans les categories 

<select name="cat"> <— Q 

<option value="//ouvrage/l i vre/"> Ouvrages </option> 

<option value="//musique/disque/"> Musique </option> 

<option value="//">Toutes </option> 

</select> 

<input type="submit" name="envoi " value="0K"/> 

</td> 

</tr> 

</tbody></table> 

</fieldset> 

</form> 

<P> 
<a href="http://val idator.w3.org/check?uri=referer"Ximg 
src=" http://www.w3.org/Icons/val id-xhtml 11" 
alt="Valid XHTML 1.1" height="31" width="88" /></a> 
</p> 
<?php 

if(isset($_POST['envoi '])) 
{ 
$choix= $_P0ST['choix']; ^© 
$cat= $_P0ST['cat'] ; <-© 
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$xml=simplexml_load_file("bibl io4.xml ") ; <— Q 

$result= $xml->xpath($cat.$choix); <— © 

//Eliminer les doublons 

$resul t=array_uni que ($ result) ; <— Q 

echo "<h3>Resultats de la recherche</h3>" ; 

//Affichage sous forme de liste 

echo "<div><ol>"; 

foreach($resul t as $valeur) <— @ 

{ 
echo "<li><big>$valeur </big></li>"; 

} 

echo "</ol></div>"; 
} 
?> 

</body> 
</html> 
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Resultats de la recherche 

1. L'crnpirc dc la hontc 

J. Ritoumelle de la faim 

3. Singue Sabour : La pierre de patience 



Figure 19-8 

Resultats de la recherche des titres dans le fichier XML 



Creation d'un fichier XML a partir d'un formulaire 

II est possible de creer un fichier XML a partir des donnees saisies dans un formulaire, 
comme vous l'avez deja realise dans un fichier texte ou dans une base de donnees 
MySQL. Vous verrez dans la section suivante qu'il est aussi possible de transferer des 
donnees d'une table de base de donnees dans un fichier XML et meme de realiser 
1' operation inverse. 

L'exemple 19-7 cree une bibliographie en ligne, qui sera enregistree dans un fichier 
XML a partir des donnees saisies dans un formulaire. Ce formulaire contient trois 
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champs de type texte, dans lesquels un visiteur peut indiquer le titre, l'auteur et la date de 
partition de l'ouvrage qu'il souhaite ajouter a la bibliographie. Celle-ci peut s'enrichir 
des choix de chaque visiteur. Les scripts utilises precedemment permettent ensuite l'affi- 
chage de l'ensemble des livres. 

Le script commence par creer un formulaire classique de saisie. La partie de code PHP 
qui se situe dans le meme fichier que le code XHTML verifie d'abord 1' envoi du formu- 
laire et si les champs texte sont bien completes (repere Q). Les valeurs de ces champs 
sont ensuite recuperees dans les variables $titre, $auteur et $date. Les caracteres 
speciaux XML sont transformes en entites de caracteres en utilisant la fonction html - 
speci al chars () (reperes ©, Q et©). 

Si le fichier biblio6.xml qui va contenir les donnees n'existepas encore (repere ©), vous 
l'ecrivez dans la variable Schxml . L'element racine se nomme <bi bl i o> et contient un seul 
element <1 ivre> (repere ©). S'il existe, son contenu est recupere dans la variable objet 
$xml (repere Q) et transfere dans la variable chaine de caracteres Schxml en appelant la 
methode asxml ( ) (repere ©). 

II vous faut a ce stade supprimer la balise de fermeture </bi bl 1 o> en utilisant la fonction 
str_replace(), qui la remplace par une chaine vide dans la variable $chxml (repere 0). 
Vous pouvez concatener les nouvelles donnees avec les anciennes et ajouter la balise 
</bibl io> afin que le document XML soit bien forme (repere ©). II ne reste plus qu'a 
enregistrer le contenu de la chaine $chxml dans le fichier bibl io6.xml a l'aide de la fonc- 
tion fi1e_put_contents( ) (repere ©). 

Exemple 19-7. Enregistrement des donnees d'un formulaire au format XML 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="fr"> 
<head> 

<meta http-equiv="content-type" content="text/html ; charset=iso-8859-l" /> 
<title>Enregistrement en XML</title> 
</head> 
<body> 
<form action= "<? $_SERVER[ ' PHP_SELF ' ] ?>" method="post" 
*»enctype="application/x-www-form-urlencoded"> 
<fieldset> 

<legend><b>Saisie de donnees</b></legend> 
<table><tbody> 
<tr> 
<td>Titre : 
<input type="text" name="titre" /> 
</td> 
</tr> 
<tr> 
<td>Auteur : 
<input type="text" name="auteur" /> 
</td> 
</tr> 
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<tr> 
<td> Date : 
<input type="text" name="date" /> 
</td> 

</tr> 

<tr> 

<td> 

<input type="submit" name="envoi " value="OK"/> 

</td> 

</tr> 

</tbody></table> 

</fieldset> 

</form> 
</body> 
</html> 

<?php 

if(isset($_POST['envoi '])&& ! empty ($_POST[ 'titre' ] )&& ! empty ($_POST[ 'auteur' ] )&& 

*■! empty ($_POST[' date'])) <-Q 



$titre= htmlspecialchars($_POST['titre']); <^© 
$auteur= html specialchars($_POST[ 'auteur ']) ; <— © 
$date= htmlspecialchars($_POST['date']); <— © 
i f ( ! f 1 1 e_exi stsC'bi bl i o5 . xml " ) ) <— 



$chxml= "<?xml version=\"l .0\" encoding=\"iso-8859-l\"standalone=\"yes\"?> 
*»\n<bibl io>\n <livre>\n <titre>$titre</titre>\n <auteur>$auteur</auteur> 
'•An <date>$date</date>\n</livre>\n</biblio>"; <^© 



$xml=simplexml_load_file("bibl io5.xml ") ; <— © 

$chxml = $xml->asxml ( ) ; <— @ 

$chxml = str_replace("</biblio>" , "", $chxml);<— Q 

$chxml.= "<livre>\n <titre>$titre</titre>\n <auteur>$auteur</auteur>\n 

*<date>$date</date>\n</livre>\n</biblio>"; <— © 

} 

$verif=file_put_contents("bibl io6.xml " ,$chxml ) ; <— © 



) 
?> 



Relations entre XML et une base MySQL 

Les fichiers XML etant lisibles par de nombreux medias, ils constituent un excellent 
moyen d'echange de donnees entre differents systemes. En particulier, vous allez les 
utiliser pour stacker les donnees d'une table MySQL dans un format structure. Cela vous 
permettra de les transmettre a d'autres applications, qui seraient incapables d'acceder 
directement aux donnees d'une base MySQL. Vous verrez egalement les moyens permet- 
tant de realiser 1' operation inverse. 
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Figure 19-9 

Formulaire de saisie des donnees a enregistrer au format XML 



Creation d'un fichier XML a partir d'une table MySQL 

Differentes mefhodes permettent de transferer les donnees d'une table MySQL dans un 
fichier XML. Ce dernier est alors utilisable par toutes sortes d' applications, incluant 
PHP, JSPetASP.Net. 

Utilisation de phpMyAdmin 

La methode la plus simple et la plus rapide pour creer un fichier XML a partir d'une base 
de donnees consiste a utiliser phpMyAdmin. Cette interface est dotee d'un script, qui 
realise cette operation automatiquement. La structure du fichier XML cree a une struc- 
ture bien determinee, qui ne correspond pas necessairement aux desirs du programmeur. 

Les regies de transformation appliquees par ce script sont les suivantes : 

• Le nom de la base devient l'element racine du document XML. 

• Le nom de la ou des tables devient un element de premier niveau. II y a done autant 
d' elements de ce type que de lignes dans la table MySQL. 

• Le nom de chaque colonne de la table devient celui d'un element imbrique dans le 
precedent, dont le contenu est la valeur du champ de la table. 

• Aucun attribut n'est cree. 

Plus generalement, si vous exportez une base entiere comportant plusieurs tables, la 
structure du fichier XML resultant est de la forme de l'exemple 19-8. Ce dernier est le 
resultat de l'exportation de la base magasi n utilisee aux chapitres 14 et 15. 

Les etapes pour exporter cette base en utilisant l'interface phpMyAdmin sont les suivantes : 

1. Choisissez la base dans la liste de selection. 

2. Cliquez sur le bouton Exporter. 

3. Selectionnez la ou les tables desirees. 
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4. Cliquez sur le bouton radio XML. 

5. Cochez la case Transmettre. 

En principe, une boite de dialogue apparait, vous invitant a enregistrer le fichier sur le 
poste. Cela ne fonctionne toutefois que si vous choisissez la compression zippe ou gzippe. 
Si vous ne choisissez aucune compression, le fichier XML s'affiche dans son integralite. 
Vous pouvez le sauvegarder avec 1' extension .xml en cliquant sur la fenetre qui contient 
le code et en selectionnant Fichier, Enregistrer sous, Nom de fichier et Type .xml. 

La figure 19-10 presente la page de l'utilitaire phpMyAdmin qui permet l'exportation 
des donnees au format XML. 



1U J.I.IL. Jllill 1.11111.1. -IJ. III..!. I..W H.UH.W IBM 

fsflEaHoirOl [J Structure JT SOL _, Ktcfceretwr ^Ht-nufte ^EaiwiMi ^imporlEf Xt**™"™* pPrwrtta*! JCSupprancf 



i**i*mi il 0wim**» 4* H 



Tnur nhbctetiM > Tnm rift 1 




rjwJetden 

CSv 

«fcmofl Lxcel JHIIHI 
WtPMOfl Wwfl IrtHlD 

LiT«X 

riEJt-j- "Upen Loium 

TijkIo 'Oyon Dtcwttti 

PDF 

SDL 

Toaln Tnsy' 

IB*" 1 

VJXUI 


r 






TrnnsmcTirr 



j 3jir.l Ghc? Pi.: - [rr: 3 d?-j \ 



Figure 19-10 

Exportation de la table article au format XML avec phpMyAdmin 



Exemple 19-8. Le fichier magasin.xml 

<?xml version="1.0" encoding="utf-8" ?> 
<!-- 



phpMyAdmin XML Dump 

version 3.0.1.1 

http : //www . phpmyadmi n . net 

Serveur: localhost 
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- Genere le : Mer 17 Decembre 2008 a 21:52 

- Version du serveur: 5.1.30 

- Version de PHP: 5.2.7 
--> 

<! — 

- Base de donnees: 'magasin' 
--> 

<magasin> 
<!-- Table article --> 
<article> 

<id_article>CS330</id_article> 

<designation>Camescope Sony DCR-PC330</designation> 
<prix>1629.00</prix> 
<categorie>video</categorie> 
</article> 
<!-Suite de la table article 

--> 

<!-- Table client --> 
<cl ient> 

<id_cl ient>K/id_cl ient> 
<nom>Marti</nom> 
<prenom>Jean</prenom> 
<age>36</age> 

<adresse>5 Av Einstein</adresse> 
<vi 1 1 e>0rl eans</vi 1 1 e> 
<mail>mart@marti . com</mail> 
</cl ient> 

<!-Suite de la table client 
--> 



<!-- Table commande --> 
<commande> 

<id_comm>K/id_comm> 
<id_cl ient>5</id_cl ient> 
<date>2004-06-ll</date> 
</commande> 

<!-Suite de la table commande 
--> 



<!-- Table ligne --> 
<1 igne> 

<id_comm>K/id_comm> 
<id_article>CS330</id_article> 
<quantite>K/quantite> 
<prixunit>1629.00</prixunit> 
</l igne> 
<!-Suite de la table ligne 

--> 

</magasin> 
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Utilisation d'un script PHP 



L' inconvenient de la methode precedente est que le structure du fichier XML cree par le 
script de phpMy Admin est determinee par avance et qu'elle ne definit aucun attribut. Si, 
pour une raison quelconque d' organisation, vous souhaitez que certaines colonnes d'une 
table deviennent des attributs ou une autre structure particuliere, il vous faut ecrire un 
script personnalise qui cree par un fichier XML approprie. 

L'exemple 19-9 en donne une illustration en creant un fichier XML nomme article. xml, 
contenant les donnees de la table article de la base magasin creee et utilisee a plusieurs 
reprises dans l'ouvrage. 

La structure choisie pour 1' exportation des donnees est la suivante : 

<article id="CS330" categorie="video"> 

<designation>Camescope Sony DCR-PC330 </designation> 

<prix>1629.00 </prix> 
</article> 

L'element <arti cl e> contient les informations sur les quatre colonnes de la table arti cl e 
mais dans une organisation differente. La cle primaire id_article de la table devient 
1'identifiant unique de l'element <article>, et la colonne categorie un attribut de cet 
element. Les sous-elements <designation> et <prix> correspondent aux colonnes de 
me me nom dans la table. 

Comme vous devez acceder a la base magasin, le script commence par inclure la fonction 
de connexion (repere O '< H etablit ensuite la connexion au serveur MySQL et recupere 
1'identifiant de connexion dans la variable $idcom (repere ©). La requete SQL est tres 
simple puisque vous souhaitez lire toutes les colonnes de la table (repere ©). Apres envoi 
de la requete (repere ©), 1' ensemble des resultats est accessible au moyen de la variable 
$ result. Vous creez alors une variable $chxml contenant la declaration XML et l'element 
racine <magasin> (repere 0). 

Une boucle whi 1 e de lecture des resultats recupere chaque ligne dans un tableau associatif 
(repere ©) et concatene les differents elements a la chaine $chxml (reperes ©. ©, O et 
©). La balise de fermeture de l'element racine </magasin> est finalement ajoutee a la 
chaine du code XML (repere©), qui est enregistree dans le fichier arti cle. xml 
(repere ©). 

Exemple 19-9. Transfert de donnees d'une table dans un fichier XML 

<?php 

incl udeC'connex.inc.php") ; <— O 

$idcom=connex( "magasin" , "myparam") ; <— © 

$requete="SELECT * FROM article"; <-© 

$result=mysql_query($requete,$idcom) ; <— O 

$chxml="<?xml version=\"1.0\" encoding=\"iso-8859-l\" standalone=\"yes\"?> 

*»\n<magasin>" ; <— © 

while($ligne=mysql_fetch_array($result.MYSQL_ASS0O) <— © 
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$chxml .="<article id=\"($l igne[ 'id_article' ]}\" categorie=\"{$l igne['categorie']) 

*\">\n"; <^© 

Schxml .=" <designation>{$l igne[ 'designation' ]} </designation>\n" ; <— © 

$chxml. = " <prix>{$ligne[ 'prix' ]} </prix>\n" ; <— Q 

$chxml.= "</article>\n"; <— © 
} 

$chxml . = "</magasin>" ; <— © 
file_put_contents("article.xml " ,$chxml ) ; <— © 
?> 

La figure 19-1 1 presente une partie du fichier XML cree par ce script. 
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<?xml version="1.0" encoding="iso-8S59-l" standalone="yes" ?> 
<rnagasin:=- 

- ^article id = "CS330" categorie="video"> 

<designation>Camescope Sony DCR-PC330-=:/designation> 

< prix > 1629. 00</prix> 
</article> 

- -^article id = "NIK55" categorie="photo"> 

<designation>Nikon F55 + zoom 28/80-=/designation> 
<prix>Z69.00</prix> 
</artide> 

- <article id = "NIK80" categorie="photo"> 

<designation:=-NikonF80< /designations 
<prix>479.00</prix> 
-=/article> 

- <article id = "SOXMP" categorie="informatique"> 

<designation>PC Portable Sony Zl-XMP</designation> 
<prix>2399.00</prix> 
</article> 

- -^article id = "HP497" categorie="informatique"> 

<designation>PC Bureau HP497 ecran TFT</designation> 

< prix >1 500. 00</prix> 
</article> 

- -^article id = "DVD75" categcirie="divers"> 

<designation>DVD vierge par 3</designation> 
<prix>17.50</prix> 
</article> 

- ^article id = "CAS07" categorie="divers"> 

<designation>Cassette DV60 par 5</designation> 
<prix>26.90</prix:=- 
</artide> 

- <article id = "DEL30" categorie="informatique"> 

<designation>Portable Dell X300</designation> 
<prix>1715.00</prix> 
</article> 

- <article id = "CP100" categorie="video"> 

<designation>Camescope Panasonic SV-AV 100</designation> 

< prix >1 490. 00</prix> 
-=/article> 

- < article id="SAX15" categorie="informatique"> 

<designation>Portable Samsung X15 XVM</designation> 

< prix >l 999. 00</prix> 
-t/flrtir:lfi> 



- 



- 



J&\ Termine 



■J Poste de travail 



Figure 19-11 

he fichier articie.xml visualise dans Internet Explorer 
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Creation d'une table MySQL a partir d'un fichier XML 

Vous pouvez maintenant realiser 1' operation inverse en inserant dans une table d'une 
base MySQL les donnees d'un fichier XML en provenance d'une source quelconque. La 
structure de ce fichier doit etre connue pour permettre de creer a l'avance la table desti- 
nee a recevoir les donnees. 

Dans l'exemple 19-11, vous recuperez les donnees d'un fichier XML ayant une structure 
identique a celle du fichier biblio3.xml utilise precedemment. L'element racine se 
nommait <bi bl i o> et son contenu etait de la forme suivante : 

<livre editeur="FAYARD" prix="20.00"> 

<titre>L'empire de la honte</titre> 

<auteur>Jean Ziegler</auteur> 

<date>2005</date> 
</l i vre> 

Les etapes necessaires sont les suivantes : 

• Creation d'une base nommee biblio si le serveur admet plusieurs bases. Dans le cas 
contraire, l'etape suivante suffit. 

• Creation d'une table nommee livre contenant six colonnes, cinq correspondant aux 
valeurs contenues dans un element <livre> plus un indispensable identifiant numeri- 
que entier auto-incremente. Ce dernier sera la cle primaire de la table de facon a ne pas 
deroger aux regies enoncees au chapitre 13. 

Pour les details de creation d'une base et d'une table, reportez-vous au chapitre 14. 
Le code de l'exemple 19-10 donne la commande SQL de creation de la table livre. 
La figure 19-12 illustre la structure affichee par phpMy Admin. 

Exemple 19-10. Code SQL de creation de la table livre 

CREATE TABLE ~livre~ ( 

Mdlivre" smal 1 i nt ( 5 ) unsigned NOT NULL auto_increment, 

'editeur* varchar(20) NOT NULL default ", 

~prix~ decimal (4,2) unsigned NOT NULL default '0.00', 

~titre~ varchar(40) NOT NULL default ", 

~auteur~ varcharOO) NOT NULL default ", 

'date" year(4) NOT NULL default '0000', 

PRIMARY KEY CidlivrV) 
) 

Afin d'operer ce transfert de donnees, vous commencez par recuperer le contenu du 
fichier biblio3.xml dans la variable objet $xml (repere ©). La connexion au serveur 
MySQL est realisee comme aux chapitres precedents par la fonction connex( ), dont vous 
devez inclure le code (repere ©) avant d'effectuer la connexion (repere ©). Vous lisez 
avec count( ) le nombre d'elements <1 ivre> presents dans le document XML en comptant 
le nombre d'elements du tableau retourne par $xml->livre (repere 0). Ce nombre est 
utilise par un boucle for (repere 0), qui lit l'ensemble des attributs editeur et prix des 



PHP 5 



elements <1 ivre> (reperes © et ©) et le contenu des sous-elements <t1tre>, <auteur> et 
<date> (reperes ©, © et ©). 



Champ 


Type Attributs Hull Defaut Extra 


idlivre 


smallint(5) UNSIGNED Non autojncrement 


editeur 


varchar(20) Non 


prix 


decimal(4,2) UNSIGNED Non 0.00 


titre 


varchar(40) Non 


auteur 


varchar(30) Non 


date 


yearf^) Non 0000 



Figure 19-12 

Structure de la table livre 



La requete d'insertion des donnees dans la table 1 i vre est ecrite dans la variable $requete 
(repere ©) puis soumise au serveur (repere ©). Une verification est operee pour s' assu- 
rer que les donnees sont inserees dans la table (repere ©). 

Exemple 19-11. Transfert de donnees XML dans une table 

<?php 

$xml=simplexml_load_file( "bibl io3.xml " ) ; <— © 

//Connexion a la base 

incl ude_once( "connex.inc.php" ) ; <— © 

$idcom= connexC'bibl io" , "myparam" ) ; <— © 

//Lecture du contenu des elements 

$nblivre= count($xml->l ivre) ; <— © 

echo "Nombre de livres : " ,$nbl ivre, "<br />"; 

for($i=0;$i<$nblivre;$i++) <— 



{ 



$editeur=$xml->livre[$i][@editeur] ; <— © 

$prix=$xml ->1 ivre[$i ][@prix] ; <— © 

$titre=htmlentities($xml->livre[$i]->titre); <— © 

$auteur=$xml->livre[$i]->auteur; <— © 

$date=$xml->livre[$i]->date; <— © 

//Requete SQL 

$requete= "INSERT INTO 1 1 vreCidl ivre, editeur, prix, titre, auteur, date) 

* VALUES ( '\N' , '$editeur' , '$prix' , '$titre' , 'Sauteur' , '$date' )" ; <-© 

//Envoi de la requete d'insertion 

$verif=mysql_query($requete,$idcom) ; <— © 

if($verif) echo "<br /> $titre insere dans la base<hr />";<—© 



} 

?> 
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Memo des fonctions et methodes 

object simplexml_import_dom(nodedom node) 

Cree un objet simplexml_element apartird'un objet DOM. 

object simplexml_load_file(str"ing nom_fichier) 

Transfere le contenu d'un fichier XML dans un objet de type simplexml_element. 

object simplexml_load_string(string chaine_xml) 

Transfere un contenu XML d'une chaine de caracteres dans un objet de type simpl exml_el ement. 

string asxml ([string nom_fichier]) 

Transfere le contenu d'un objet de type simplexml_element dans une chaine. Si vous fournissez un parametre, la 
methode enregistre le fichier sur le serveur. 

object attributesO 

Retourne un objet dont les proprietes sont les attributs de I'objet simpl exml_el ement auquel vous appliquez la methode. 

object childrent ) 

Retourne un objet dont les proprietes sont les elements enfants de I'element auquel vous appliquez la methode. 

array xpath(string requete_path) 

Effectue une requete XPath sur les donnees de I'objet auquel vous appliquez la methode. 

Exercices 

Exercice 1 

Creez un fichier XML nomme iut.xml, dont I'element racine est <1ut>. Les elements 
principaux nommes <etudiant> ont comme attributs id (numero d' inscription) et nom. 
Chaque element <etudiant> peut contenir autant d'elements <uv> que desire. Chaque UV 
doit avoir un nom, une duree et une note enregistres dans des sous-elements. Visualisez 
ce fichier dans un navigateur pour verifier qu'il est bien forme. 

Exercice 2 

Lisez les elements et les attributs du fichier iut.xml, et affichez-les dans un tableau 
XHTML. 

Exercice 3 

Creez un formulaire permettant d'inserer des donnees dans le fichier iut.xml. Le script 
doit permettre la visualisation eventuelle du fichier apres 1' insertion. 

Exercice 4 

Creez un formulaire de recherche permettant d'afficher a la demande les noms des 
etudiants par ordre alphabetique, ainsi que la liste des UV et leur nom. 
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Exercice 5 

Transferez toutes les donnees de la base ventures creee aux chapitres 13 et 14 dans un 
fichier XML d'abord en utilisant phpMy Admin puis en ecrivant un script PHP. La repar- 
tition des donnees dans des attributs ou comme contenu des elements est libre. 

Exercice 6 

Transferez les donnees du fichier i ut.xml de l'exercice 3 dans une table MySQL. Creez la 
table auparavant en lui donnant comme cle primaire la valeur de l'attribut i d de l'etudiant. 
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Le framework PEAR 



En informatique, et particulierement en POO, il est d'usage de dire qu'il ne faut pas rein- 
venter la roue. En effet, a quoi bon reecrire du code qui a deja ete fait et teste par d'autres, 
pour parvenir au meme resultat. C'est cette idee qui a prevalu lors de la creation des 
frameworks et de PEAR en particulier. PEAR est un ensemble de tres nombreux modules 
adaptes aux situations les plus diverses que Ton peut rencontrer lors de la creation de 
sites Web. Chaque module ou package est un ensemble de scripts ecrits en PHP. L'arrivee 
de PHP 5 et de son modele objet plus elabore que celui, tres primaire, de PHP 4, permet 
a PEAR de proposer desormais, pour chaque module, des classes dotees de nombreuses 
methodes qui vous permettent d'utiliser aisement, et surtout d'adapter a vos besoins parti- 
culiers, chaque module. II existe d'autres frameworks Open Source que PEAR comme 
Zend, Symphony. . . mais notre choix s'est porte sur PEAR non seulement parce que c'est 
l'un des plus anciens, qu'il est bien etabli et constamment mis a jour, mais surtout parce 
qu'il nous semble plus facile d'acces. 



Installer PEAR 



II est possible de recuperer les differents packages de PEAR sur le site http://pear.php.net, 
mais il existe un moyen plus pratique qui consiste a utiliser un installeur qui permet non 
seulement d'installer les packages de base, mais aussi de gerer la recherche et l'installa- 
tion des packages en fonction de vos besoins ainsi que de les mettre a jour en un clic. 
Pour cela, il vous faut tout d ' abord recuperer le fichier nomme g o - p e a r . p h p soit sur le site 
de PEAR cite plus haut, soit dans le repertoire wamp/apps dans lequel vous avez installe le 
serveur local Wampserver2. Transferez-le ensuite sur le serveur de votre site distant via 
un logiciel FTP, comme pour les fichiers habituels, puis lancez-le a partir d'un navigateur. 
Vous obtiendrez la page presentee a la figure 20-1. Laissez-vous alors guider et fournissez 
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vos parametres de connexion FTP. L'installeur PEAR se chargera de transferer sur le 
serveur les fichiers necessaires a toutes les applications PEAR. 



i$ PEAR :: Installer : Go-PEAR - Mozilta Fi'*fcw 






H w U *£ httpi/'lacalhDsfgD-pejr.php 


pea^ 


1 Go-PEAR Installer L 


Version 1.1.2 1 


■ 

" ^Welcome to Go-PCAR 


Welcome to go-pear 1.1.21 


4 figuration 

•installation 
•Completed 


Go pear will Install Pear r Its Web Frontend and 

all the needed files. 1 his 

fmntnnri is ynur tool for PFAR Installation and 

maintenance. 




Gri-fHMi n\y.a ]v.[t; yon tiuwukrdii mwi inslnlE \\w. 

following optional PCAR 

package;^: PFAR FrunlnriEJ Wub-bntfl, 

PCAR Trontend Gtk2, MDD2. 




Ntixl » 




k 




Temint 



Figure 20-1 

L'installeur de PEAR 

Une fois les packages de base installes, vous disposerez d'un gestionnaire de packages. 
La page du PEAR Package Manager est presentee a la figure 20-2. 
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Webbased PEAR Package Manager on www.funhtml.co 
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PutkLiytt Search 
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Uiiinnel MiinayeineriL 
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Configuration 



Warning: I his puLkiiytf miiriayeinerit website is nut pru tutted with <j pa byword, this ib ii MAJDK secuiity risk. 
Please read ti«p h>a[)mk 



Package pe a r. php.net/ HTM I^QuickForm, Documentation files: 

* docs/rcn dcrors/tem platcs/styl cs/fancygrou p .htm I 

* dots/renderers/tem plates/styl es/green. html 

* drjtb/ieiidtfrerb/Leriiplatesi/fltfxy dynamic, html 

* Jotb/feiidererb/tKriiplalea/fleKy static. hum I 

* (lLH:K/i«ii[J«rprK/lHriif]|jilHK/htinl.h1rnl 

■ flncs/ren rierprFt/tpm platps/it-dyna m I c-2 -htm I 
» rtrwfi/ren riGrprFt/tpm plates/lt-dyna m I c . htm I 
» flf>rs/ren.rierpr(Vtpm plates/It- statl r . htm I 

* docs/ren dcrcrs/ tern platcs/labc I . html 

* docs/rcndcFcrs/tcm pjatcs/sma rty-dy na mtc-fa ncygrou p . tp I 

* docs/rendcrers/tem platcs/sma rty-dy na m ic -g rcen .tpl 

* drjtb/rendererbyteriipiutes/biiTiijrlLy dynamic. tpl 

* ducs/jeiidererb/Leriiplales/snifcirty staLit/.tpl 

* dutb/ieiidererij/'l-leKyUyiiiJiriit.exiiTTiiple.pkp 
» fifK^flnrifirprfi./] Iexysrarir_pxample.php 

» rincB/.renrierflrR./TTrivnfl rnTr _pjcarnple . p hp 
» fincfi/wnriflrprR./ ITDy na mlr _pxample? . php 

* doc^rcnderers/ITStatic cxample.php 

* docs/rendcrers/multiplc- la bcl s . php 



Figure 20-2 

Le PEAR package Manager 
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Chapitre 20 

Grace a ce dernier, vous pouvez choisir puis installer automatiquement les packages 
dont vous avez besoin. Pour vous donner une idee de ce que PEAR peut vous offrir 
nous allons maintenant, a titre d'initiation, mettre en oeuvre de package PEAR HTML_ 
QuickForm qui permet de creer des formulaires XHTML. 

Le package HTML_QuickForm 

Installez tout d'abord, dans le Package Manager, le package HTML_QuickForm dans le reper- 
toire www/pear/ de votre serveur, par exemple. Celui-ci vous permet, comme son nom 
l'indique, de creer simplement des formulaires sans avoir a ecrire directement de code 
XHTML. II est meme envisageable de creer ces formulaires dynamiquement et d' adapter 
leurs champs au visiteur du site, afin de creer, par exemple, un questionnaire different s'il 
s'agit d'un particulier ou d'une entreprise, d'un homme ou d'une femme. 

La demarche a suivre est la suivante: 

1. Inclure les fichiers PEAR necessaires (en regie generale ils sont indiques dans la 
documentation des classes). 

2. Creer un objet representant l'ensemble du formulaire correspondant a l'element 
XHTML <form>. 

3. Creer les objets representant les composants visibles (ou eventuellement caches) du 
formulaire. II peut s'agir d'elements de saisie de texte ou de mot de passe, de boutons 
radio, d'envoi, d'effacement, de cases a cocher ou encore de listes deroulantes de 
selection correspondant aux elements XHTML <1 nput />, <sel ect> et <opti on>. Notez 
que les elements seront visibles dans l'ordre de leur codage. 

4. Ajouter ces objets a l'objet formulaire. 

5. Creer des regies de validation du formulaire qui consistent a verifier qu'il est bien 
complete ou que les donnees ont un format correct. 

6. Afficher le formulaire explicitement dans la page XHTML. 
Ce sont ces differentes phases que nous allons aborder maintenant. 

Lobjet formulaire 

C'est une instance de la classe HTML_Qui ckForm dont le constructeur a pour syntaxe : 

HTML_QuickForiri( string nomp, string methode, string action) 

Les parametres correspondent aux attributs de l'element <form> : nomp correspond aux 
attributs id ou name qui identifient l'element pour y faire reference dans un style CSS par 
exemple ; methode vaut ' get ' ou ' post ' et c'est cette derniere valeur que nous utiliserons ; 
action designe le nom du fichier PHP qui traitera les donnees saisies dans le formulaire, 
si vous l'omettez ce sera par defaut le fichier qui cree le formulaire lui-meme. 

Avant de creer l'objet, il faut inclure le fichier QuickForm.php qui contient le code de la 
classe instanciee. 
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Nous avons done par exemple le code suivant : 



I 



require_once"HTML/QuickForm.php" ; 

$form = new HTML_QuickForm( 'forml ' , 'post', 'traitement.php' ) ; 



Nous pouvons ensuite creer un en-tete de presentation contenant un texte a 1' attention du 
lecteur. Ceci se fait, comme l'ajout des autres elements, avec la methode addEl ement( ) de 
l'objet $form selon la syntaxe : 

$form->addElement( 'header' , ", 'Completez le questionnaire'); 

Composants de saisie de texte 

Les composants de saisie de texte permettent au visiteur de donner son nom, son e-mail, 
son mot de passe (dans ce cas, les caracteres saisis sont caches) ou des longs textes, 
comme des commentaires. II existe plusieurs techniques pour ajouter des composants a 
un formulaire, la plus simple etant la methode addEl ementO de l'objet $form, dont les 
parametres indiquent le type de l'element, mais nous avons choisi ici d'employer celle 
qui utilise les classes specialisees, adaptees a chaque type de composant. 

Les elements de texte simple 

Les elements de texte simple sont des instances de la classe HTML_QuickForm_text dont le 
constructeur a pour syntaxe : 

HTML_QuickForm_text(string nom, string label, divers attributs) 

Outre le nom de l'element, la definition du parametre label permet d'afficher un texte 
devant la zone de saisie. Le parametre attri buts permet d'affecter des valeurs aux attri- 
buts de l'element XHTML <input />, sous la forme soit d'une chaine du type 
"attri but=valeur", soit d'un tableau associatif dont les elements s'ecrivent attri but 
=>valeur. 

Pour creer, par exemple, une zone de texte demandant le nom d'une personne, precedee 
du label « Votre nom » et d'une largeur visible de 55 caracteres, nous ecririons le code 
suivant : 

Irequire_once ' HTML/Qui ckForm/text.php' ; 
$txtnom=new HTML_QuickForm_text( 'nom' , 'Votre nom' , 'size=55' ) ; 
$form->addElement($txtnom); 

Cet objet possede plusieurs methodes dont on peut retenir les suivantes : 

• setSize(string N) fixe la taille visible a N caracteres ; 

• setMaxlength(string N) limite la taille du texte saisi a N caracteres ; 

• getVal ue( ) recupere la valeur saisie ; 

• setVal ue(stri ng texte) definit le texte de la zone (afin de pre-remplir un questionnaire 
par exemple). 

Le resultat obtenu est represente a la figure 20-3, repere Q. 
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Les elements de saisie de mot de passe 

lis se differencient des precedents par le fait que les caracteres saisis sont remplaces par 
des points. Ce sont des objets de type HTML_QuickForm_password dont la syntaxe du cons- 
tructeur est : 

HTML_QuickForm_password(string nom, string label, divers attributs) 

Les parametres ont ici les memes roles que pour l'element texte. La methode setMax- 
length(N) permet de forcer un mot de passe a avoir N caracteres au maximum. Le fichier 
ainclure est password. php. 

Le code de creation d'une zone de saisie de mot de passe limite a 6 caracteres serait : 

require_once 'HTML/QuickForm/password.php' ; 

$pass= new HTML_QuickForm_password( 'pass' , 'Votre pass'); 

$pass->setMaxLength( '6' ) ; 

$form->addElement($pass) ; 

Le resultat obtenu est represente a la figure 20-3 repere ©. 

Les elements de texte multiligne 

lis permettent a un visiteur de saisir, par exemple, un commentaire de plusieurs lignes. 
Ce sont des objets du type HTML_QuickForm_textarea dont le constructeur a pour syntaxe : 

HTML_QuickForm_textarea(string nom, string label, divers attributs) 

Dans le cas de cet element, certains attributs sont indispensables et vous devez les definir 
sous la forme d'un tableau qui sera passe comme troisieme parametre. Par exemple, pour 
creer une zone de saisie de texte de 55 caracteres de large et de 16 lignes de haut, nous 
creons le tableau suivant : 

$optarea=array("rows"=>16, "cols"=>55) ; 

puis l'objet lui-meme : 

Irequire_once 'HTML/QuickForm/textarea.php' ; 
$zone= new HTML_QuickForm_textarea( 'zonel' , 'Vos commentai res' ,$optarea) ; 
$form->addElement($zone) ; 

La methode setVal ue( ) permet de definir un texte qui sera affiche dans la zone de saisie 
pour preciser la demande, comme : 

$zone->setValue( ' Ecrivez vos commentai res ici'); 

Les dimensions peuvent etre modifiees dynamiquement avec les methodes : 

I$zone->setCols(50); //pour avoir 50 caracteres de marge 
$zone->setRows(15) ; //pour avoir 15 lignes de haut 

Le resultat obtenu est represente a la figure 20-3 repere ©. 
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Les boutons radio 

lis permettent d'effectuer des choix, exclusifs l'un de 1' autre si vous leur attribuez le 
meme nom, ou independants si les noms sont differents. Les objets sont du type HTML_ 
Qui ckForm_radi o et le fichier a inclure est radio. php. La syntaxe du constructeur est : 

IHTML_QuickForm_radio(string nom, string label, string texte, string valeur, 
^•divers attributs) 

Le parametre label permet de presenter le ou les boutons, texte constitue le choix 
propose et valeur est la chaine qui sera recuperee par le programme de traitement des 
donnees. 

Le code de creation de deux boutons radio exclusifs l'un de 1' autre (meme parametre nom) 
et proposant le choix du sexe serait done : 

require_once ' HTML/Qui ckForm/ radio. php' ; 

$radiol=new HTML_QuickForm_radio( 'sex' , 'Votre sexe' , 'Homme' , ' H' ) ; 

$radio2=new HTML_QuickForm_radio( 'sex' , ' ' , ' Femme' , ' F' ) ; 

$form->addElement($radiol); 

$form->addElement($radio2); 

Le resultat obtenu est represente a la figure 20-3 repere ©. 

Les cases a cocher 

Les cases a cocher permettent de faire des choix et autorisent les choix multiples. Les 
objets correspondants sont du type HTML_QuickForm_checkbox et il faut inclure le fichier 
checkbox, php. La syntaxe du constructeur est la suivante : 

HTML_QuickForm_checkboxCstring nom, string label, string texte, divers attributs) 

Les parametres nom, 1 abel et texte sont identiques a ceux des boutons radio et il est neces- 
saire d'ajouter au moins un attribut, sous la forme d'une chaine "value=valeur", pour 
designer la valeur associee a chaque case qui sera recuperee sur le serveur. 

Pour proposer au visiteur de preciser ses gouts, nous aurions par exemple deux cases a 
cocher creees par le code suivant : 

require_once ' HTML/Qui ckForm/ checkbox. php' ; 

$casel=new HTML_QuickForm_checkbox( 'easel ' , 'Vos Gouts', 'Sucre', 'value=l'); 

$case2=new HTML_QuickForm_checkbox( 'case2' , ", 'Sale', 'value=2'); 

$form->addElement($casel) ; 

$form->addElement($case2) ; 

Les objets checkbox possedent, entre autres, les methodes getTextO et setTextO 
employees respectivement pour lire ou definir le texte associe a la case ; les methodes 
getValueO et setValueO pour lire ou modifier la valeur associee et, enfln, getCheckedO 
qui permet de cocher dynamiquement un case. 

Le resultat obtenu est represente a la figure 20-3 repere 0. 
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Les listes de selection 

Les listes de selection permettent d'effectuer un ou plusieurs choix dans une liste derou- 
lante d'options predeterminees. L'objet PEAR est du type HTML_QuickForm_select et le 
fichier a inclure est sel ect . php. Le constructeur a pour syntaxe : 

HTML_QuickForm_select(string nom, string label, array options); 

Les options de la liste sont fournies dans un tableau associatif dont les cles correspondent 
aux valeurs qui seront recuperees sur le serveur et les valeurs aux textes visibles des 
options. La mefhode addOption(string texte, string valeur) permet d'ajouter dynami- 
quement des options a la liste (notez que les parametres sont dans l'ordre inverse par 
rapport au tableau). Pour autoriser les choix multiples dans la liste, il faut appeler la 
methode setMulti pie (boolean). Pour creer une liste de trois options, puis ajouter une 
nouvelle option et autoriser les choix multiples, nous aurions le code suivant : 

require_once 'HTML/QuickForm/select.php' ; 

$taboptions=array( 'un'=>'0ption 1', 'deux'=>'Option 2', 'trois '=>'0ption 3'); 

$liste= new HTML_QuickForm_select( '1 iste' , 'Votre choix', Staboptions) ; 

$form->addElement($liste) ; 

$1 iste->addOption( 'Option 4' , 'quatre' ) ; 

$liste->setMultiple(TRUE); 

Le resultat obtenu est presente a la figure 20-3, repere Q. 

Le package QuickForm permet aussi de creer, avec tres peu de code, des listes de selection 
de dates avec plusieurs listes deroulantes pouvant contenir l'heure, le jour, le mois ou 
l'annee pour saisir des informations comme une date de naissance complete. Ce type 
d'objet est tres pratique car, pour ecrire l'equivalent en XHTML, il faudrait creer trois 
listes contenant une option par jour, mois ou annee, ce qui representerait des dizaines de 
lignes. Le type d'objet est HTML_QuickForm_date et il faut inclure le fichier date. php. La 
syntaxe du constructeur est : 

HTML_QuickForm_date(string nom, string label, array options) 

Le tableau associatif options contient quatre elements dont les cles sont 'language', 
'format', 'minYear' et 'maxYear'. Pour avoir les jours et les mois en francais, il suffit de 
donner la valeur ' f r ' au parametre ' 1 anguage ' . Le format definit les informations que va 
contenir la liste a partir des options presentees dans le tableau 20-1. 

Tableau 20-1. Options du parametre format de l'objet QuickForm 

Caractere Signification 

D Le jour de la semaine en trois lettres 

I (L minuscule) Le jour de la semaine en entier 

d Le quantieme du mois 

M Le nom du mois en trois ou quatre lettres 

F Le nom du mois en entier 
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Tableau 20-1. Options du para met re format de I'objet QuickForm (suite) 



m 


Le numero du mois 


Y 


L'annee en quatre chiffres 


y 


L'annee en deux chiffres 


h 


L'heure deO a 12 


H 


L'heure de a 23 


i Les minutes 


s 


Les secondes 


a 


Affichage am/pm 


A 


Affichage AM/PM 



Pour definir un intervalle de saisie de dates comprenant le jour du mois, le mois et 
l'annee comprise entre 1959 et 2009, nous aurons le tableau suivant : 



ions = array( 






'language' 


=> 


'fr', 


'format' 


=> 


'dMY' 


'minYear' 


=> 


'1959 


'maxYear' 


=> 


'2009 



Pour creer I'objet date ci-dessus nous ecrivons le code suivant : 



ions = array( 






'language' 


=> 


'fr', 


'format' 


=> 


'dMY', 


'minYear' 


=> 


'1959' 


'maxYear' 


=> 


'2009' 



); 
$listedate= new HTML_QuickForm_date( ' 
$form->addElement($listedate) ; 



istedate', 'Date de naissance', Soptions); 



Comme il n'y a qu'un seul nom pour ce composant et en realite trois elements XHTML 
<select>, pour pouvoir recuperer les informations dans des variables via la superglobale 
$_P0ST, la classe cree un tableau multidimensionnel dont les cles de premier niveau sont 
les lettres utilisees dans la definition du format. Pour I'objet date, dont le nom est 
1 1 stedate, le tableau retourne est le suivant : 



["1 istedate"]=> array(3) 
*string(4) "1959" 



["d"]=> string(l) "1" ["M"» string(l) "1" ["Y"]=> 



Le resultat obtenu est presente a la figure 20-3, repere Q 
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Les champs caches 

Comme leur nom l'indique, ce sont les seuls elements du formulaire qui ne sont pas visi- 
bles par l'utilisateur. lis servent a transmettre au serveur des informations non saisies, 
comme le nom du navigateur utilise ou la date exacte d'envoi du formulaire. Ce sont 
des objets du type HTML_QuickForm_hidden et le fichier a inclure est hidden.php. Le cons- 
tructed a pour syntaxe : 

HTML_QuickForin_hidden( string nom, string valeur); 

Pour illustrer leur emploi nous creons avec le code ci-dessous un champ cache qui trans- 
met le timestamp de l'envoi, fourni par la fonction timet ) : 

require_once 'HTML/QuickForm/hidden.php' ; 
$cache=new HTML_QuickForm_hidden( '1 adate' , timeO); 
$form->addElement($cache) ; 

La valeur transmise est bien un element du tableau $_P0ST. 



Les boutons d'envoi 

Un formulaire ne se concoit pas sans quelques boutons, au minimum un bouton d'envoi 
(submit) declenchant l'envoi des donnees au serveur qui les traite et, eventuellement, un 
bouton de reinitialisation qui remet les champs dans leur etat initial en cas de mauvaises 
saisies. Chacun d'eux correspond aux types d'objets HTML_QuickForm_submit et HTML_ 
QuickForm_reset. Les fichiers a inclure sont submit, php et reset, php. Les constructeurs ont 
pour syntaxe : 

IHTML_QuickForm_submit( string nom, string valeur) 
HTML_QuickForiri_reset(string nom, string valeur) 

Le parametre val eur est surtout utile quand le formulaire contient, par exemple, plusieurs 
boutons d'envoi, ce qui permet de decider quelle action effectuer dans le script de traite- 
ment des donnees apres l'envoi. Un formulaire se termine done generalement par le code 
suivant : 

require_once 'HTML/QuickForm/submit.php' ; 

require_once ' HTML/Qui ckForm/ reset. php' ; 

$reset=new HTML_QuickForm_reset( 'efface' , ' Effacer' ) ; 

$form->addElement($reset) ; 

$envoi=new HTML_QuickForm_submit( 'envoi ', ' Envoyer' ) ; 

$form->addElement($envoi ) ; 



Le resultat obtenu est presente a la figure 20-3, reperes © et 0. 



Les regies de validation 



Un bon formulaire doit egalement etre capable de verifier si les saisies du visiteur sont 
conformes a certaines regies. Certains champs peuvent, par exemple, etre obligatoires, le 
mot de passe peut etre limite a un nombre de caracteres minimal ou maximal et l'e-mail 



PHP 5 



doit obligatoirement repondre a un format international reconnu. C'est dans ce domaine, 
bien plus que dans la creation automatique de code XHTML, que QuickForm revele tout 
son interet pour vous faire gagner du temps de developpement et de test. II est en effet 
tres simple d'ajouter des regies de validation au formulaire avec la methode addRuleO, 
dont la syntaxe est la suivante : 

I$form->addRule(string nom_element, string message, string regie, divers info, 
**string lieu); 

Le premier parametre est le nom du composant de formulaire a valider et le second, 
le message affiche en cas de non conformite. Le parametre regie precise, quant a lui, le 
type de regie a utiliser. II en existe une dizaine, adaptees aux cas les plus courants. Les 
mots-cles a utiliser sont enumeres dans le tableau 20-2. 

Tableau 20-2. - Les regies de validation. 



Regie 


Signification 


1 


requi red 


Le champ doit obligatoirement etre complete. 




tnaxlength 


II faut saisir un nombre maximum de caracteres. 




mini ength 


II faut saisir un nombre minimum de caracteres. 




rangelength 


II faut saisir un nombre de caracteres compris dans un intervalle. 




email 


L'adresse e-mail doit etre conforme au format normalise. 




lettersonly 


Seuls les caracteres alphabetiques sont autorises. 




alphanumeric 


Seuls les caracteres alphanumeriques sont autorises. 




numeric 


Seuls les chiffres sont autorises. 




nopunctuation 


Aucun signe de ponctuation n'est admis. 




nonzero 


La saisie ne doit pas comporter de zero. 





Certaines regies doivent etre precisees a l'aide du quatrieme parametre, qui peut etre une 
chaine de caracteres contenant un nombre pour les regies maxl ength et mini ength, ou un 
tableau de la forme array(Min, Max) pour la regie rangelength. Le dernier parametre, lieu, 
indique si la verification doit etre effectuee cote client avec JavaScript, ou cote serveur 
avec PHP ; ce parametre prend done la valeur 'client' ou 'server ' . Pour rendre la saisie 
du mail obligatoire et verifier sa conformite cote client nous ecrivons : 

I$form->addRule( 'mail ' , 'Indiquez un mail valide', 'email', null, 'client'); 
$form->addRule( 'mail ' , 'Indiquez votre mail', 'required', null, 'client'); 

Les messages d'information indiquant qu'un champ est obligatoire et ceux des boites 
d'alerte JavaScript etant libelles en anglais, nous pouvons les franciser a l'aide des 
methodes suivantes de l'objet $form : 

I//Francisation des messages 
$form->setRequiredNote( '* = Saisie obligatoire'); 
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pour l'avis des saisies obligatoires et : 

$form->setJsWarnings( ' Reponse non valide ','Corrigez la saisie'); 

pour les boites d'alerte. 

L'exemple 20-1 recapitule la creation de tous les elements que nous venons d'aborder. 
Nous y trouvons tout d'abord 1' inclusion des differentes fichiers necessaires a la creation 
des objets du formulaire (repere ©)> puis nous creons l'objet representant le formulaire 
(repere ©) suivi par l'en-tete de presentation (repere ©). Viennent ensuite les champs de 
texte et d' e-mail (repere ©), le mot de passe (repere ©) et la zone de saisie de commen- 
taires (repere ©), puis les boutons radio (repere Q) et les cases a cocher (repere ©). 
Les elements suivants sont les listes deroulantes classiques (repere Q ) et de dates 
(repere ©). Nous concluons la liste des elements visibles par la creation des boutons 
d'envoi et d'effacement (repere ©). Un champ cache termine la creation des composants 
(repere ©). L'ajout de regies de validation permet de controler les saisies de 1' e-mail, du 
nom et du code (repere ©) et, enfin, nous appelons des methodes de francisation des 
messages (repere©). La methode displayO permet alors d'afficher le formulaire 
(repere ©). 

Exemple 20-1. Creation d'un formulaire avec QuickForm 

<!D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml " xml :lang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Formulai re HTML_QuickForm</title> 
</head> 
<body> 
<?php 

//Inclusion des fichiers <— O 
require_once "HTML/QuickForm.php" ; 
require_once 'HTML/QuickForm/textarea.php' j 
require_once 'HTML/QuickForm/text.php' ; 
require_once ' HTML/Qui ckForm/radio.php' ; 
requi re_once ' HTML/Qui ckForm/checkbox.php' ; 
require_once 'HTML/QuickForm/select.php' ; 
requi re_once 'HTML/QuickForm/password.php' j 
require_once 'HTML/QuickForm/date.php' ; 
requi re_once 'HTML/QuickForm/hidden.php' ; 
requi re_once 'HTML/QuickForm/submit.php' ; 
requi re_once ' HTML/Qui c kForm/ reset. php ' ; 

//Creation du formulai re <— © 

Sform = new HTML_QuickForm( 'forml' , 'post' , 'traitement. php' ) ; 

//Creation d'un en-tete <— Q 

$form->addElement( 'header' ,'' , 'Completez le questionnaire'); 
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//Composants de texte <— © 

$txtnom=new HTML_QuickForm_text( 'nc 

$form->addElement($txtnom); 

//Ou encore 

//$form->addElement( 'text' , 'nom' , 'Votre nom 

$txtprenom=new HTML_QuickForm_text( 'prenom' 

$form->addElement($txtprenom) ; 

$mail=new HTML_QuickForm_text( 'mail ', 'Votre mai 

$form->addElement($mail ) ; 



Votre nom' , 'size=55' ) ; 



'size=55' ) ; 
Votre prenom' 



D; 



'size=55' ) ; 



//Password <— Q 

$pass= new HTML_QuickForm_password( 'pass' , 'Votre pass'); 

$pass->setMaxLength( '6' ) ; 

$form->addElement($pass) ; 

//Texte long <— © 

$optarea=array("rows"=>"16" , "cols"=>"55") ; 

$zone= new HTML_QuickForm_textarea( 'zonel ' , ' Vos commentai res ' ,$optarea) ; 

$zone->setCols(50); 

$zone->setRows(5) ; 

$zone->setValue( ' Ecri vez vos commentai res ici'); 

$form->addElement($zone) ; 



//Radio ^© 

$radiol=new HTML_QuickForm_radio( 'sex' , 'Votre sexe 

$radio2=new HTML_QuickForm_radio( 'sex' , ' ' , ' Femme' , 

$form->addElement($radiol); 

$form->addElement($radio2); 



, 'Homme' , 'H' ) ; 

F'); 



//Checkbox <^Q 

$casel=new HTML_QuickForm_checkbox( 'easel', 
$case2=new HTML_QuickForm_checkbox( 'case2', 
$form->addElement($casel) ; 
$form->addElement($case2) ; 



'Vos Gouts ', 'Sucre' , 'value=l' ) ; 
' ' , 'Sale' , ' value=2' ) ; 



//Select <-0 

$taboptions=array( 'un'=>' Option 1 ' 

$liste= new HTML_QuickForm_select( 

$form->addElement($liste) ; 

$liste->addOption( 'Option 4' , 'quatre 

$liste->setMultiple(TRUE); 



deux'=>'Option 2' , 'trois '=>'0ption 3'); 
iste' , 'Votre choix' ,$taboptions) ; 



//Selection de dates <—© 
Soptions = array( 'language 
'••'maxYear' => '2009'); 
$listedate= new HTML_QuickForm_date( 
$form->addElement($listedate) ; 



=> 'fr' , 'format' => 'dMY' , 'minYear' => '1959', 



I istedate' , 'Date de naissance' .Soptions) ; 



//Boutons envoi et effacement <— © 
$reset=new HTML_QuickForm_reset( 'efface' 



' Effacer ' ) ; 
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$form->addElement($reset) ; 

//Ou encore 

//$form->addElement( ' reset' , 'efface', 'Effacer'); 

$envoi=new HTML_QuickForm_submit( 'envoi ', ' Envoyer' ) ; 

$form->addElement($envoi ) ; 

//Ou encore 

//$form->addElement( 'submit ' , 'envoi', 'Envoyer'); 



//Champ cache ^© 

$cache=new HTML_QuickForm_hidden( ' 

$form->addElement($cache) ; 



adate' ,time( ) ) ; 



//Regies de verification <—© 

$form->addRule( 'mail ' , 'Indiquez un mail valide', 'email ' .null , 'client' ) ; 

'Indiquez votre mail', 'required', null, 'client'); 

Indiquez votre nom', 'required', null, 'client'); 

'Pass!', 'required', null, 'client'); 

'Code numerique', 'numeric', null, 'client'); 

'Code 4 chiffres mini', 'minlength', '4', 'client'); 



$form->addRule( 'mail 
$form->addRule( 'nom' 
$form->addRule( 'pass 
$form->addRule( 'pass 
$form->addRule( 'pass 



//Francisation des messages <—© 
$form->setRequi redNote( '* = Saisie obi igatoire' ) ; 
$form->setJsWarnings( ' Reponse non valide ','Corrigez la saisie'); 

//Affichage du formulaire complet<— © 
$form->display( ) ; 
?> 

</body> 
</html> 

La figure 20-3 montre le resultat obtenu. 



Recuperation des donnees 

Les donnees du formulaire sont recuperables dans la variable superglobale $_P0ST, 
comme nous l'avons vu au chapitre 6. Pour le formulaire que nous venons de creer 
certaines donnees, comme celles du composant de date, sont transmises sous forme de 
tableau. Le fichier traitement.php, designe comme dernier parametre du constructeur de 
l'objet formulaire, peut avoir la forme suivante pour afficher toutes les saisies : 



<?php 
foreach($_POST as 



icle=>$valeur) 



if (is_array($valeur) ) 
{ 

foreach($valeur as $cle=>$ssvaleur) echo "Element : $cle Valeur associee 

*$ssvaleur <hr />"; 
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?> 



echo "Element 



tele Valeur associee : $valeur <hr />" 



^-"-l" 



i Farmulaire HTM L_QuickForm - Mozilla Firefox 



Fichicr Edition Affichogc Historiquc Marque poc|C3 Outils ? 

yM * O ® ( ^_ http:,'VlDca[ho5t , 'chap2Ci/fjijicld.php 



V A / T | |OH Gp ^ fe 



Completez le questionnaire 
"Voire nom 1 
Voire prenom 



"Voire mail Ma^hin 



*\ otre pass *•«• 



VOS LOIUEUtfUlilLreS ftr^rivp?: vn« ™imniMit:«irM ir.i 



Votrc sexe Homme 
Femme. 
Vos Goyts Sucre 



Voire ehnlx Option I " 
Option 2 
Option 3 
Option 4 - 



Date de naissance 01 * Jan 



Fffaner 



Envoyei 



- 1959 

8 






Saisie obligatoire 



Figure 20-3 

Leformulaire cree avec QuickForm 



PEAR : une multitude de packages 

Comme nous l'avons indique des le debut de ce chapitre, PEAR fournit une tres grande 
quantite de packages adaptes a toutes les situations de creation de sites statiques ou dyna- 
miques. Le tableau 20-3 indique la liste des categories de packages, les chiffres entre 
parentheses indiquant le nombre de packages compris dans chacune d'elles, soit un total 
de plusieurs centaines. II semble difficile de ne pas y trouver l'application desiree. On 
peut conseiller, entre autres, les packages HTML_CSS dans le groupe HTML pour la creation de 
styles, MDB2 dans le groupe Database, une couche d'abstraction pour la connexion a une 
base de donnees quelconque, ou encore Auth_HTTP dans le groupe Authentifi cation pour 
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la securite d'acces et le groupe Mail. Vous pouvez retrouver cette liste et les liens vers la 
liste complete des packages de chaque groupe a l'adresse : http://pear.php.net/packages.php. 
Chaque package possede sa propre documentation avec, generalement, des exemples tres 
utiles pour demarrer ainsi que la syntaxe des methodes et des proprietes des objets qu'il 
contient. 



Tableau 20-3 - Les differentes categories de packages PEAR, 
entre parentheses le nombre de packages compris dans la categorie 



Authentication (8) 


Benchmarking (1) 


Caching (2) 


Configuration (1) 


Console (7) 


Database (31) 


Date and Time (22) 


Encryption (13) 


Event (2) 


File Formats (33) 


File System (6) 


Gtk Components (4) 


Gtk2 Components (7) 


HTML (40) 


HTTP (14) 


Images (19) 


Internationalization (6) 


Logging (1) 


Mail (8) 


Math (19) 


Networking (55) 


Numbers(2) 


Payment (5) 


PEAR (20) 


PEAR Website (5) 


PHP (20) 


Processing (1) 


Science (1) 


Semantic Web (5) 


Streams (2) 


Structures (30) 


System (8) 


Text (19) 


Tools and Utilities (9) 


Validate (29) 


Web Services (41) 


XML (32) 



Exercices 



Exercice 1 

Creez un formulaire ayant pour titre « Adresse client ». II doit contenir les champs de 
saisie du nom, du prenom, de l'adresse, de la ville et du code postal. Ajoutez-y les regies 
de verification qui s'imposent. 

Exercice 2 

Realisez un formulaire de saisie de login, e-mail et mot de passe, ce dernier doit 
comprendre entre 6 et 9 caracteres. Creez les regies de verification. 
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Exercice 3 

Concevez un formulaire demandant la saisie d'un prix HT et d'un taux de TVA. Le script 
doit afficher le montant de la TVA et le prix TTC dans deux zones de texte creees dyna- 
miquement. Les champs ne devant comporter que des chiffres et etre obligatoires, creez 
les regies de verification correspondantes. 
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Travaux personnels 



Plutot que de clore l'ouvrage par des etudes de cas, souvent difficiles a suivre pour qui ne 
les pas ecrites, nous vous proposons quatre themes de travaux personnels qui constituent 
en quelque sorte des sujets de memoire de fin d'etudes sur PHP. Chacun d'eux consiste a 
creer un site de complexite croissante. Des uns aux autres, les descriptifs sont de moins 
en moins detailles afin de vous mettre progressivement dans une situation reelle de crea- 
tion de site. 

Les corriges de ces travaux personnels sont telechargeables depuis le site des edi- 
tions Eyrolles (http://www.editions-eyrolles.com) sur la page dediee a l'ouvrage. Les sites 
correspondants peuvent en outre etre consultes en fonctionnement reel sur le site Web 

http://www.funhtml.com/php5. 



Demarche a suivre 

Pour chaque projet vous devrez suivre la demarche suivante : 

1. Lire attentivement le cahier des charges propose. 

2. Decomposer le site en differents modules, auxquels correspondront autant de pages. 

3. Etablir un schema general de fonctionnement mettant en relief les liens entre ces 
differentes pages. 

4. Tracer les grandes lignes de 1' organisation de chaque page sous forme de schema, en 
separant le code HTML du code PHP. 

5. Ecrire le code de chaque partie sans trop entrer dans les details de design dans un 
premier temps. Le design relevant plus du designer que du programmeur, il ne vous 
concerne pas ici. 
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6. Effectuer des tests approfondis sur chaque page en essayant d'envisager les divers 
comportements des utilisateurs, leurs erreurs eventuelles et les effets de celles-ci sur 
votre code. 

7. Mettre en place l'ensemble des pages et tester leurs interactions dans les memes 
conditions. 

8. Si possible, faire tester le site par des personnes n'ayant aucune connaissance particu- 
liere du domaine et noter leur comportement vis-a-vis de 1' interface proposee. Noter 
en particulier leurs hesitations et les questions qu'elles se posent pour acceder au 
service rendu par le site. Ce qui est evident pour le concepteur ne Test pas forcement 
pour les utilisateurs. 

TP n° 1 . Un site de rencontres 

Ce premier theme, deja ebauche au chapitre 16, est le plus simple. 
Son cahier des charges est le suivant : 

• Le site offre aux internautes sportifs la possibilite d'entrer en contact avec d'autres 
personnes pratiquants ou supporters d'un meme sport dans un departement donne. 

• Le site est realise avec PHP et une base SQLite. 

• Chaque page affiche un en-tete commun. 

• Pour avoir acces aux informations du site, chaque visiteur s'enregistre au prealable en 
tant que pratiquant ou supporter d'au moins un sport. 

• L' identification se fait par le biais de l'e-mail du visiteur. Une fois identifie, le visiteur 
a acces a une page de recherche affichant les coordonnees des personnes qui repondent 
aux criteres qu'il a definis. L'autorisation d'acces et l'e-mail sont stockes dans un cookie. 

• Un visiteur non enregistre souhaitant acceder a la page de recherche est redirige auto- 
matiquement vers la page d'inscription. 

• Si un visiteur deja identifie veut s'inscrire pour un autre sport que celui de sa premiere 
inscription, le formulaire affiche ses coordonnees automatiquement dans le formulaire 
afin de lui faciliter la saisie. 
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L'interface comprend trois pages, la page d'accueil, la page d'inscription et la page de 
recherche, chacune dotee de fonctionnalites specifiques. 

La page d'accueil 

Nommee index. php, la page d'accueil contient les elements suivants : 

• En-tete commun. 

• Liste des sports existants dans la base. 
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• Zone de saisie de l'e-mail pour identifier le visiteur. Si l'e-mail figure deja dans la 
base, un message de bienvenue s'afflche avec le nom du visiteur, et les donnees 
personnelles du visiteur sont enregistrees dans un cookie. Deux nouveaux liens sont 
crees dynamiquement, un vers la page de recherche et un vers la page d'inscription, 
permettant de s'enregistrer pour un nouveau sport. Si l'e-mail ne figure pas dans la 
base, le visiteur est redirige automatiquement vers la page d'inscription. 

• Lien vers la page d'inscription pour les personnes non encore enregistrees. 

La page d'inscription 

Nommee ajout.php, la page d'inscription contient les elements suivants : 

• En-tete commun. 

• Formulaire HTML d'enregistrement comprenant trois zones principales : 

- La premiere comporte les zones de saisie de texte pour le nom, le prenom, le depar- 
tement et l'e-mail. 

- La deuxieme contient une zone de selection proposant le choix des sports existant 
dans la table sport. Cette liste est construite dynamiquement a partir des selections 
des sports existants dans la base par les utilisateurs. Une seconde liste de selection 
permet a l'utilisateur de choisir son niveau. Les choix possibles sont « debutant », 
« confrrme », « pro » ou « supporter ». Une zone de saisie de texte et un bouton 
d'envoi particulier permettent au visiteur d'ajouter un nouveau sport dans la table 
s'il n'est pas propose dans la liste. Apres l'enregistrement du nouveau sport, le visi- 
teur est dirige vers la page d'inscription mise a jour avec ce nouveau sport. 

- Le formulaire se termine par les habituels boutons d'envoi et de reinitialisation. 

• Lien vers la page d'accueil. 

• Script verifiant 1' existence de saisies dans les zones de texte et les listes de selection, 
enregistrant les donnees dans la base sporti f s et affichant l'identifiant genere. 

La figure 21-1 illustre ce que pourrait etre le formulaire de la page d'inscription. 

La page de recherche 

Nommee recherche. php, la page de recherche contient les elements suivants : 

• En-tete commun. 

• Formulaire de saisie contenant trois listes de selection : 

- La premiere contient la liste des sports existants. Elle est construite dynamiquement 
a partir des donnees de la table sport, comme dans la page d'inscription. 

- La deuxieme indique le niveau des pratiquants et comporte les memes valeurs que 
dans le formulaire d'inscription. 

- La troisieme contient la liste des departements dans lesquels il existe des personnes 
inscrites. Elle est construite dynamiquement a partir des donnees de la table 

personne. 
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Figure 21-1 

Leformulaire d' inscription 

• Lien vers la page d' accueil. 

• Lien vers la page d' inscription. 

• Script traitant les informations saisies et affichant la liste des partenaires correspon- 
dants dans un tableau XHTML. Les donnees saisies sont reaffichees dans le formulaire 
afin de faciliter une eventuelle nouvelle recherche de l'utilisateur. 

Le formulaire de recherche doit ressembler a celui illustre a la figure 21-2. 
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Figure 21-2 

Le formulaire de recherche 
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La base de donnees SQLite 

La definition des besoins pour la conception de la base de donnees sportifs a deja ete 
abordee au chapitre 16. Les contraintes a respecter sont les suivantes : 

• Les entites en presence sont une personne et un sport. 

• Une personne peut pratiquer un ou plusieurs sports. La cardinalite du cote de l'entite 
personne est done l.N. 

• Un sport peut etre pratique par une ou plusieurs personnes. La cardinalite du cote de 
l'entite sport est done egalement l.N. 

• Ces entites sont reliees par l'association pratique, qui possede l'attribut niveau. 
Le modele conceptuel de donnees, ou MCD, est illustre a la figure 21-3. 
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Figure 21-3 

Le modele conceptuel de donnees de la base 

En appliquant les regies de normalisation presentees au chapitre 13, vous obtenez le 
modele logique de donnees illustre a la figure 21-4. La table pratique represente l'asso- 
ciation entre les tables personne et sport. Sa cle primaire est la concatenation des cles 
primaires des tables qu'elle associe. Elle a de plus un attribut niveau. 
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Figure 21-4 

Le modele logique de donnees (MLD) de la base 



TP n° 2. Dictionnaire de citations interactif 

Ce TP est une premiere mise en oeuvre simple d'une base de donnees MySQL. Le projet 
consiste a creer un dictionnaire de citations litteraires interactif en ligne. II ne s'agit pas 
done d'une banque de donnees statique mise en consultation. Chaque visiteur peut en 
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enrichir le contenu avec ses citations preferees, qui sont ensuite rendues accessibles a 
tous. Le concept du site se rapproche de celui d'un forum puisque les donnees ne sont pas 
figees. 



Linterface 



Pour creer une unite dans le site, chaque page doit incorporer les memes en-tete et pied 
de page. L'interface comprend trois pages, la page d'accueil, la page d'affichage des 
resultats et la page d' insertion. 

La page d'accueil 

Nommee index. php, la page d'accueil comporte, outre les elements decoratifs laisses a 
votre libre choix, les elements suivants : 

• Bandeau contenant la citation du jour tiree au sort dans la base et affichee lors de 
chaque connexion. 

• Formulaire de recherche contenant une zone de saisie de texte dans laquelle le visiteur 
saisit un mot-cle de recherche d'une citation. II peut aussi preciser sa recherche en 
choisissant dans une liste de selection parmi les auteurs presents dans la base. Cette 
liste est construite dynamiquement en interrogeant la base. Un dernier critere de selec- 
tion est constitue d'une seconde liste de selection permettant de choisir le siecle des 
citations, du xvi e au xxi e . Le critere de tri des resultats se fait par auteur ou par siecle 
en fonction du choix effectue a l'aide de boutons radio. Aucun de ces criteres n'etant 
obligatoire, chaque choix doit posseder une valeur par defaut consistant a afficher 
P ensemble des citations. Le script de traitement de ce formulaire se trouve sur la page 
d'affichage des resultats. 

• Lien vers la page d' insertion de nouvelles citations. 

La page d'affichage des resultats 

Nommee af f i checi t . php, la page d'affichage des resultats contient les elements suivants : 

• Script gerant les saisies du formulaire. Ce script construit la requete SQL dynamique- 
ment en fonction des choix operes par le visiteur dans la page de recherche et gere 
P absence de mot-cle et de choix dans les listes de selection afin de ne pas creer de 
blocage du fait d'une requete mal construite. 

• Resultats de la recherche effectuee par un visiteur. Chaque citation est presentee dans 
une cellule de tableau HTML et est suivie du nom de P auteur et de son siecle. Le tri 
des citations se fait par siecle ou par nom d'auteur selon le choix fait par le visiteur. 

• Lien vers la page d' accueil. 

• Lien vers la page d' insertion. 



Travaux personnels 

Chapitre21 



La page d'insertion 

Nommee saisiecit.php, la page d'insertion comprend les elements suivants : 

• Formulaire contenant deux zones de saisie de texte pour le nom et le prenom de 
l'auteur, une liste de selection du siecle, une zone de saisie multiligne pour le texte 
de la citation, ainsi que les habituels boutons d'effacement et d' envoi. 

• Script de traitement des donnees situe dans le flchier lui-meme, devant verifier si 
l'auteur existe deja dans la base puis inserer les donnees et afficher un avis d'insertion 
pour le visiteur. 

• Lien vers la page d'accueil. 

La figure 21-5 donne une idee de ce que pourrait etre le formulaire d'insertion (ici pour 
les rencontres sportives du TP n° 1). 
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Figure 21-5 

Le formulaire d'insertion 



La base de donnees MySQL 

Nommee di co, la base de donnees doit repondre au modele conceptuel de donnees repre- 
sente a la figure 21-6. Les contraintes sont les suivantes : 

• Un auteur peut avoir ecrit plusieurs citations. 

• Une citation donnee ne peut etre l'ceuvre que d'un seul auteur. 
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Figure 21-6 

Le modele conceptuel de donnees de la base dico 

Le modele logique de donnees realise en appliquant les regies du chapitre 13 est illustre 
a la figure 21-7. II montre que la base dico ne contient que deux tables. 
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Figure 21-7 

Le modele logique de donnees de la base dico 



TP n° 3. Commerce en ligne 

Ce troisieme theme a pour but de vous placer dans une situation professionnelle. 

Vous y jouez le role d'un concepteur independant vis-a-vis d'un client qui n'est pas un 
professionnel du Web mais un commenjant. II ne peut done exprimer ses besoins dans 
un langage technique propre a Internet et a la programmation PHP, dont il ignore tout. 



Les besoins du client 

Le client dirige une PME qui vend des produits informatiques et video. Vous devez lui 
creer un site de commerce en ligne pour vendre ses produits par correspondance. Son 
budget ne lui permettant pas de vous remunerer en permanence pour maintenir le site, 
vous lui creez une interface Internet a acces prive lui permettant d'ajouter ou d'enlever 
des produits dans la base de donnees sans avoir a passer par un logiciel FTP. 
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Voire travail 



Comme vous n'allez pas reinventer le concept de commerce en ligne et partir de zero, 
vous vous inspirerez de ce qui existe deja. Vous consul terez pour cela des sites de vente 
en ligne tels que eyrolles.com pour en etudier le fonctionnement. 

II vous faudra en degager les points essentiels et n'en retenir que ce qui correspond au cas 
relativement simple de votre client. 

En particulier, le nombre d' articles vendus par cette PME est relativement limite compara- 
tivement a ceux du site d'Eyrolles. Cela peut entrainer des simplifications dans la structure 
de la base, comme le fait de ne pas creer de table speciale pour enregistrer le nom des 
marques des produits en magasin. 

Pour acceder a MySQL, utilisez de preference l'extension mysqli (voir le chapitre 16) 
ou, encore mieux, pour les courageux, realisez une version mysqli puis une version PDO 
(voir le chapitre 17). 

Fonctionnement du site 

Le site repond aux conditions suivantes : 

• Dans la page d'accueil, le client recherche un type de produit dans une des categories 
informatique, video et divers (pour les accessoires et consommables). Un tri par 
marque et par prix est propose pour l'affichage des resultats. 

• Les resultats de la recherche sont affiches en respectant le critere de tri. Chaque 
produit est suivi d'un lien permettant sa selection. 

• La selection d'un produit entraine sa mise en panier. 

• Apres chaque selection, le client peut soit rechercher un autre produit, soit terminer sa 
commande. 

• Dans ce dernier cas, l'ensemble de sa commande est affichee, et vous lui demandez 
ses coordonnees. 

• Si le client n'est pas encore enregistre, il saisit ses coordonnees completes. Son 
adresse e-mail et un mot de passe lui serviront a s' identifier par la suite. II saisit egale- 
ment le cas echeant 1' adresse de livraison, qui peut etre differente de 1' adresse du 
client. Ces informations sont stockees a l'aide de sessions pour etre transmises aux 
pages suivantes de la procedure d' achat. 

• Si le visiteur est deja client, il ne saisit que son e-mail et son mot de passe. L'authenti- 
cite de ces informations est verifiee dans la base, et les coordonnees completes du 
client sont recuperees. Ces coordonnees sont utilisees pour remplir automatiquement 
un formulaire identique a celui du visiteur non enregistre. Ces informations sont egale- 
ment stockees a l'aide de sessions. 

• La phase de paiement par carte bancaire n'etant pas realisable sans une convention 
bancaire, vous vous contentez de demander la saisie d'un numero de carte et d'utiliser 
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un algorithme de verification du numero. Vous trouverez cet algorithme sur Internet en 
faisant une recherche a partir du mot-cle cle de Luhn. 

• Si le paiement est bien realise, vous finalisez la transaction en enregistrant 1' ensemble 
des informations dans les tables client, commande et ligne puis affichez le numero de 
commande a destination du client. 

• Pour finir, vous envoyez un e-mail de confirmation au client et au depot du magasin 
charge de la livraison. 

La base de donnees MySQL 

La base de donnees etant susceptible d'etre soumise a de nombreux acces concurrents, le 
choix de MySQL s'impose par rapport a SQLite. La base magasin a deja ete presentee en 
detail au chapitre 13. La figure 21-8 presente le modele conceptuel de donnees de cette 
base. 
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Figure 21-8 

Le modele conceptuel de donnees de la base magasin 

Ce modele est impose afin que chaque lecteur travaille sur la meme base. N'ajoutez 
aucun attribut aux entites representees dans le modele. II vous appartient de recreer le 
MLD correspondant avant de creer la base avec phpMy Admin. 

Conseils 

Les quelques conseils suivants vous permettront de realiser plus facilement ce TP : 

• Etablissez le schema de fonctionnement du site avant de commencer le moindre codage. 

• Reportez-vous au chapitre 13 pour etablir precisement le MLD de la base. 

• Reportez-vous aux chapitres 14 et 15 pour utiliser MySQL et revoir la partie concer- 
nant les jointures entre tables. 

• Reportez-vous au chapitre 12 pour implementer les sessions, les cookies et les e-mails. 

• La creation de fonctions de traitement est recommandee. 

• Ne vous precipitez pas sur le corrige en cas de probleme. Laissez d'abord decanter vos 
idees. 
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TP n°4. Creation d'un blog 

Voici comment le site Wikipedia definit un blog (http://fr.wikipedia.org/wiki/Blog) : « un blog 
(mot-valise de web log) ou blogue est un site web constitute par la reunion de billets 
agglomeres au ill du temps et souvent classes par ordre dechronologique (les plus recents 
en premiers). Chaque billet (appele aussi note ou article) est, a 1' image d'un journal de 
bord ou d'un journal intime, un ajout au blog ; le blogue ur (celui qui tient le blog) y deli- 
vre un contenu souvent textuel, enrichi d'hyperliens et d' elements multimedias, sur 
lequel chaque lecteur peut generalement apporter des commentaires. » 

II existe quantite de sites proposant soit d'heberger des blogs, soit des logiciels de crea- 
tion de blog (Wordpress par exemple, a l'adresse http://fr.wordpress.org/). Mais, encore une 
fois, notre but est de comprendre le fonctionnement d'une technologie et non pas d'utili- 
ser un produit fini. 

Vous devez done gerer : 

• L'acces reserve pour une ou plusieurs personnes munies d'un identiflant et d'un mot 
de passe. 

• La saisie par ces personnes d'un contenu (generalement sans interet). 

• L'affichage de ces contenus imperissables (le plus recent d'abord). 

• La possibilite pour les visiteurs passionnes d'ajouter des commentaires. 

• La validation des commentaires par les personnes autorisees. 
L'ensemble doit etre realise avec PHP et MySQL, gere par PDO. 
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Jean Engels 

Enseignant en mathematiques et consultant Web, Jean Engels est auteur de nombreux ouvrages 

portant sur les technologies du Web : (X)HTML, CSS, JavaScript, PHP et MySQL. 



Un cours ideal pour assimiler la syntaxe et les concepts objet de PHP 5 
et s'initier au developpement d'applications Web professionnelles 

Ce manuel d'initiation vous conduira des premiers pas en PHP jusqu'd la realisation d'un site Web complet interagissant avec 
une base de donnees MySQL ou SQLite. 

Apres avoir appris a installer PHP et a creer quelques pages simples, vous etudierez en detail la syntaxe du langage 
(variables, types de donnees, operateurs, instructions, fonctions, tableaux...), avant de progresser rapidement vers des sujets 
de niveau plus avance : programmation objet, manipulation des cbaines de caracteres et expressions regulieres, gestion des 
mails, sessions et cookies, acces aux bases de donnees MySQL et SQLite, traitements XML, etc. 

Parmi les themes nouveaux abordes dans cette seconde edition : les nouveautes objet de PHP 5.3, 1'acces objet a MySQL, 
I 'acces PDO a MySQL et a SQLite, le framework PEAR. 

Des exercices corriges et des travaux pratiques 

pour une mise en ceuvre immediate de vos connaissances 

Pour vous aider a valider et mettre en ceuvre vos connaissances, vous trouverez en fin de chaque chapitre une serie d'exercices 
dont les corriges et le code source sont disponibles sur les sites www.editions-eyrolles.com et www.funhtml.com. Vous decouvri- 
rez egalement en fin d'ouvrage quatre exemples de sites Web dynamiques presented sous forme de travaux pratiques : a vous 
de developper ces applications a partir du cahier des charges et des indications donnees dans I'enonce, en resistant a la tenta- 
tion de telecharger trop rapidement les solutions donnees sur le site des Editions Eyrolles ! 

A qui s'adresse ce livre ? 

• Aux etudiants en cursus d'informatique ou de design Web. 

• A toute personne ayant des bases de programmation Web (HTML, JavaScript. ..) et souhaitant s'autoformer a PHP. 

• Aux enseignants et formateurs a la recherche d'une methode pedagogique pour enseigner PHP. 

Au sommaire 

Premier contact avec PHP • Variables, constantes et types • Les instructions de controle (if-else, for, while. . .) • Les chaines de 
caracteres et les expressions regulieres • Les tableaux • Les formulaires • Les fonctions • Dates et calendriers • La programma- 
tion objet (classes et instances, heritage, namespaces. . .) • Les images dynamiques • La gestion des fichiers • Cookies, sessions 
et emails • Rappels sur les bases de donnees relationnelles • Le langage SQL et phpMyAdmin • Acces procedural a MySQL avec 
PHP • Acces objet a MySQL avec PHP • PDO et MySQL • La base de donnees SQLite • PHP et SimpleXML • Le framework PEAR • 
Travaux diriges : site de rencontres, dictionnaire de citations interactif, site de commerce electronique, creation d'un blog. 
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